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9.3.4_ 在 旧版 本 .NET 中 使 用 FormattableString 






























































版权 声明 


Original English language edition, entitled C# in Depth, 4th Edition by Jon 
Skeet, published by Manning Publications. 20 Baldwin Road, PO Box 761, 
Shelter Island, NY 11964 USA. Copyight © 2019 by Manning Publications. 


Simplified Chinese-language edition copyright © 2020 by Posts & Telecom 
Press. All rights reserved. 


本 书 中 文 简 体 字 版 由 Manning Publications 授 权 人 民 邮 电 出 版 社 独家 出 
版 。 未 经 出 版 者 书面 许可 ， 不 得 以 任何 方式 复制 或 抄 玲 本 书 内 容 。 


版 权 所 有 ， 侵 权 必 完 。 








献 词 


说 以 此 书 敬 平等 ， 在 现实 世界 中 ， 其 实现 难度 远 胜 于 重 写 Equals() 方 
法 和 GetHashcode() 方 法 。 





对 第 3 版 的 赞誉 


这 是 每 一 位 .NET 开 发 者 的 必 读 图 书 。 


Dror Helper，Better Place 软 件 架 构 师 





阅读 这 本 书 是 深入 学 习 C# 语 言 特性 的 最 佳 途径 


一 一 Andy Kirsch，Venga 软 件 架构 师 


这 本 书 将 我 对 C# 的 认 知 提升 到 了 新 的 高 度 。 


一 Dustin Laine，Code Harvest 创 始 人 





这 本 书 为 我 了 解 C# 这 门 有 趣 的 编程 语言 开启 了 大 门 。 


Ivan TodoroviE，AudatexGmbH 高 级 软件 开发 者 





这 是 我 找到 的 最 好 的 C# 参 考 书目 。 


Jon Parish，Datasift 软 件 工 程 师 





这 是 C# 开 发 者 知识 进 阶 的 推荐 书目 。 
一 一 D. Jay， 美 国 亚 马 逊 评论 员 


对 第 2 版 的 赞誉 


如 果 你 想 精 通 C#， 那 么 本 书 是 必 读 之 作 。 


一 一 Tyson S. Maxwell，Raytheon 资 深 软件 工程 师 


我 们 打赌 这 是 最 好 的 关于 C# 4 的 图 书 。 


Nikander Bruggeman 和 Margriet Bruggeman, Lois & Clark IT 
Serivces.NET 顾 问 





这 本 书 中 关于 C# 4 的 独到 见解 实用 且 引 人 入 胜 。 


Joe Albahari，LINQPad 和 C# 4.0 in a Nutshell 作者 





所 有 专业 的 C# 开 发 者 都 应 该 阅读 这 本 书 。 


一 ”Stuart Caborn，BNP Paribas 资 深 开 发 者 








这 本 书 是 局 度 关注 C# 所 有 主要 版 本 中 语言 更 新 的 专家 级 资源 。 对 于 所 有 
想 掌握 C# 语 言 最 新 动态 的 专业 开 太 人 员 来 说 ， 这 本 书 必 不 可 少 。 


Sean Reilly，Point2 Technologies 程 序 员 和 分 析 师 








为 什么 要 一 过 又 一 遍地 阅读 基础 知识 ?” 乔 恩 关 注 的 是 有 嚼 劲 儿 的 新 东 
西 ! 


Keith Hill，Agilent Technologies 软 件 架 构 师 








这 里 有 你 还 没 意 识 到 但 需要 掌握 的 所 有 C# 知 识 。 


Jared Parsons， 微 软 资深 软件 开发 工程 师 





简 言 之 ， 这 有 是 我 读 过 的 最 好 的 计算 机 图 书 。 


Craig Pelkie， 作 家 、System iNetwork 访 程 讲师 





多 年 来 我 一 直 使 用 C# 进 行 开 发 ， 但 这 本 书 依然 让 我 惊喜 连连 。 它 对 委 
托 、 匿 名 方法 和 协 变 逆 变 的 绝妙 介绍 让 我 印象 深刻 。 即 使 是 经 验 丰 富 的 
开发 者 ， 也 能 从 这 本 书 中 学 到 C# 语 言 中 一 些 鲜 为 人 知 的 东西 。 本 书 之 深 
入 ， 是 其 他 C# 图 书 所 无 法 企及 的 。 


一 Adam J. Wolf，Southeast Valley .NET 用 户 组 


作者 将 关于 C# 内 部 机 理 的 丰富 知识 ， 汇 集成 了 你 手 上 这 本 文笔 流畅 、 简 
洁 实 用 的 书 。 





Jim Holmes，Windows Developer Power Tools 作 者 





普 群 严 认 ， 示 例 精确 ， 用 最 少 的 代码 展示 了 最 全 面 的 特性 .……… 阅 读 这 本 书 


真是 难得 的 至 受 ! 











Franck Jeannin， 现 国 亚 马 进 评论 员 


如 果 你 用 C# 做 了 几 年 的 开发 ， 并 且 想 了 解 一 些 内 部 原理 ， 那 么 这 本 书 绝 


对 适合 你 。 


Golo Roden， 作 家 、 演 说 家 、.NET 相 关 技 术 培 训 师 





这 是 我 读 过 的 最 好 的 C# 图 书 。 


一 Chris Mullins, C# MVP 
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时 间 真 是 奇妙 。 


本 书 动 笔 之 初 距离 现在 已 经 过 去 了 很 长 时 间 ， 其 中 不 少 内 容 随 着 书 的 版 
本 迭代 延续 至 今 ， 有 些 特性 甚至 已 有 十 年 之 龄 。 这 本 书 的 主体 内 容 于 
2016 年 至 2018 年 底 完成 ， 英 文 版 于 2019 年 出 版 。 那 时 C# 8 尚未 问世 ， 我 
也 忙于 在 各 种 用 户 群 组 发 表演 讲 。 每 当 C# 8 的 预览 版 发 生变 化 ， 我 都 会 
修改 书 中 的 相应 内 容 。 


如 今 再 写 这 篇 序 已 经 是 2020 年 7 月 ， 微 软 官方 也 宣布 了 C# 9 的 相关 计划 
(预计 2020 年 11 月 正式 发 布 ) 并 提供 了 C# 9 预览 版 。 该 版 本 将 会 推出 非 
常 重要 的 新 特性 ， 其 中 我 最 期 待 的 特性 是 记录 类 型 。 


截至 目前 我 还 没有 下 载 C# 9 的 预 宽 版 ， 我 自己 对 此 也 有 些许 寞 。 


当然 ， 在 C# 9 正式 发 布 之 前 ， 我 一 定 会 下 载 并 使 用 预览 版 ， 只 不 过 目前 
意愿 并 不 强烈 。 这 并 不 是 因为 我 对 即将 推出 的 新 特性 有 任何 保留 意见 ， 
抑或 对 在 上 自己 的 计算 机 上 安装 预览 版 心 存 顾虑 〈 微 软 在 保持 .NET Core 
和 Visual Studio 的 安装 独立 性 方面 一 直 做 得 很 棒 ) ， 只 是 因为 我 目前 正 
忙于 其 他 一 些 事 情 。 


写 这 篇 序 时 我 人 在 英国 ， 英 国 当 前 的 疫情 相 比 一 个 月 前 有 所 好 转 。 上 周 
末 我 和 朋友 们 进行 了 一 次 户外 烧烤 在 保持 社交 距离 的 前 提 下 〉 ， 再 过 
儿 周 我 们 还 要 一 起 为 我 父母 举办 金婚 庆典 (同样 会 在 保持 社交 距离 的 前 
提 下 ) 。 但 不 管 怎样 ， 这 次 疫情 已 经 深刻 影响 了 我 们 的 生活 方式 ， 其 中 
也 包括 我 个 人 时 间 的 分 配方 式 。 


在 疫情 管控 的 这 段 日 子 里 ， 我 周末 的 很 多 时 间 用 来 编写 C# 代 码 ， 主 要 涉 
及 两 个 项 目 : 一 个 项 目 是 开发 Windows 应 用 程序 V-Drum Explorer， 用 于 
简化 我 去 年 购置 的 那 套 电子 架子 鼓 设 备 烦 琐 的 配置 工作 ;， 另 一 个 项 目 与 
Zoom 视 频 会 议 有 关 〔 为 教会 提供 远程 服务 ) ， 用 于 方便 地 播放 视频 以 
及 切换 焦点 人 物 等 。 除 此 以 外 ， 还 有 一 些 规模 较 小 的 C# 编 码 工 作 ， 不 过 
这 两 个 项 目 是 最 主要 的 。 


以 上 两 个 项 目 都 使 用 了 C# 8， 而 我 目前 依然 在 努力 探索 C# 8 的 各 项 新 特 
































性 ， 以 此 不 断 加强 对 C# 语 言 的 整体 学 习 。 以 我 目前 对 C# 的 掌握 ， 该 过 
程 已 经 不 再 是 探索 C# 语 言 的 茶 些 未 知 功能 ， 而 是 不 断 答 试 使 用 不 同 的 方 
式 来 解决 相同 的 问题 ， 以 期 找到 最 优 和 解决 方案 。 这 种 目 由 探索 的 乐趣 ， 
只 能 在 个 人 的 业余 试验 性 项 目 中 才能 体会 到 ， 在 工作 中 或 是 Noda Time 
这 类 严肃 的 开源 项 目 中 则 不 可 能 体会 到 。 


我 目前 还 没有 开始 学 习 C# 9， 因 为 我 的 主要 精力 依然 集中 于 对 C# 的 整体 


学 习 。 


未 来 我 肯定 会 着 手 编写 本 书 第 5 版 。 第 5 版 一 定 会 覆盖 C# 8、C# 9 以 及 C# 
10 的 相关 内 容 。 不 过 仅仅 是 设想 一 下 这 项 工作 ， 也 令 我 心 生 旦 惧 ， 想 要 
逃避 “【〈 写 书 对 我 来 说 是 一 个 痛 并 快乐 着 的 过 程 ) 。 或 许 我 去 年 就 应 该 开 
始 第 5 版 的 创作 ， 虽 然 直到 现在 也 未 能 开始 ， 但 似乎 也 无 伤 大 雅 ， 因 为 
第 4 版 应 当 足 以 满足 读者 现 阶 段 的 需求 。 


希望 读者 可 以 积极 学 习 C# 8、C# 9 和 C# 10 的 相关 内 容 ， 不 过 请 牢记 ， 
学 习 一 门 语言 绝 不 仅仅 只 是 学 习 新 特性 。 我 使 用 C#i 滞 言 已 将 近 20 年 ， 至 
今 仍然 需要 针对 不 同 的 任务 类 型 尝试 不 同 的 解决 方案 ， 并 一 直 乐 在 其 
中 。 在 此 由 衷 地 希望 读者 可 以 从 本 书 获得 启发 ， 多 角度 地 认识 C# 语 言 并 
不 断 和 尝试 新 方法 。 同 时 ， 和 希望 这 篇 序 可 以 抛砖引玉 ， 让 读者 有 兴趣 编写 
一 些 试验 性 质 的 代码 (最 好 是 现 有 的 、 待 改进 的 代码 ) ， 来 体会 那 种 无 
须 患 得 患 失 的 纯粹 乐趣 。 


这 场 全 球 疫情 过 去 之 后 ， 估 计 我 们 再 也 无 法 回 到 从 前 的 生活 状态 了 ， 届 
时 我 们 的 认 知 也 将 与 疫情 前 大 不 相同 。 和 希望 大 家 可 以 借 此 机 会 完成 不 同 
程度 的 自我 重 塑 。 我 们 从 这 场 大 灾难 中 能 学 到 的 将 远 不 止 是 研发 新 疫苗 
和 重视 卫生 。 和 希望 每 个 人 都 能 从 中 体会 到 关怀 、 人 文 与 目 然 的 价值 。 


最 后 视 大 家 在 学 习 C# 的 道路 上 一 帆 风 顺 ， 并 在 本 书 的 陪伴 下 能 够 体验 激 
| 
新 。 
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10 年 时 间 ， 对 于 普通 人 来 说 可 谓 漫长 ， 而 对 于 一 本 面向 专业 开发 人 员 的 
技术 书 来 说 ， 几 乎 就 是 它 的 一 生 。 自 微软 发 布 Visual Studio 2008 与 C# 

3.0 已 经 过 去 10 多 年 ， 距 离 我 第 一 次 阅读 本 书 第 1 版 的 初稿 也 已 经 过 去 10 
多 年 ， 想 到 这 里 我 内 心 无 比 震 动 。 本 书 作 者 乔 恩 加 入 Stack Overflow 也 
已 超过 10 和 年， 如今 他 已 成 为 Stack Overflow 最 负 盛 名 的 传奇 人 物 。 


早 在 2008 年 ，C# 就 已 经 是 一 门 庞 大 、 复 杂 的 编程 语言 了 。 这 10 余 年 间 ， 
C# 的 设计 和 实现 团队 从 未 有 过 一 丝 懈 人 铺 。 我 很 激动 地 看 到 C# 创 新 性 地 
满足 了 不 同 开 发 者 群体 的 需求 一 一 从 电子 游戏 到 网 站 底层 ， 再 到 低层 次 
的 、 高 度 健壮 的 系统 组 件 。C# 充 分 利用 自身 学 术 研 究 的 优势 ， 并 将 其 与 
解决 实际 问题 的 应 用 技术 相 结 合 。C# 不 是 一 门 教条 的 纯 学 术语 言 。C# 
设计 团队 从 来 不 会 问 :“ 设 计 这 个 特性 的 最 面 同 对 象 的 方法 是 什 

么 ? “设计 这 个 特性 的 最 具 函 数 式 风格 的 方法 是 什么 ?”” 他 们 会 这 样 
问 : “设计 这 个 特性 最 实际 、 安 全 且 有 效 的 方法 是 什么 ? ”* 乔 恩 就 是 这 样 
一 位 务实 主义 者 。 他 不 仅 解 释 了 C# 语 言 的 工作 方式 ， 而 且 解 释 了 所 有 相 
人 
Ts 


在 本 书 第 1 版 的 序 中 我 曾 提 到 ， 乔 恩 热 情 、 博 学 、 睿 知 、 好 求知 、 普 分 
析 ， 并 且 是 一 名 优秀 的 教师 。 如 今 他 依然 具备 这 些 品 质 ， 而 且 我 要 补充 
两 项 : 坚韧 与 奉献 。 写 书 是 一 项 十 分 艰巨 的 工作 ， 尤 其 是 利用 业余 时 间 
完成 ， 更 加 令 人 钦 假 。 同 时 乔 恩 还 要 不 断 复查 已 完成 的 内 容 以 持续 更 
新 ， 而 这 项 工作 乔 恩 已 经 为 这 本 书 完成 了 3 次 。 有 些 作者 可 能 倾 癌 于 进 
行 微调 或 是 新 增 一 章 ， 而 乔 恩 的 工作 更 像 是 大 规模 重 构 。 最 终 本 书 过 硬 
的 内 容 质量 充分 说 明了 一 切 。 


随 着 C# 语 言 的 不 断 演 进 和 发 展 ， 我 迫不及待 想 要 看 到 下 一 代 程 序 员 会 和 
C# 擦 出 怎样 的 火花 。 我 希望 你 能 够 像 我 一 样 喜 爱 这 本 书 ， 同 时 感谢 你 选 
择 C# 作 为 编程 语言 。 



































Eric Lippert 


Facebook 软 件 工 程 师 


»/。 


采 言 


欢迎 阅读 本 书 第 4 版 。 在 编写 本 书 第 1 版 时 ， 我 没有 想到 10 年 后 我 依然 在 
同一 本 书 上 耕 扯 ， 而 如 今 已 是 第 4 版 了 。 也 许 10 年 后 我 还 会 编写 新 的 版 
本 。 目 C# 语 言 面 世 以 来 ， 其 设计 团队 一 直 在 努力 推动 它 不 断 演进 。 


这 一 点 很 重要 ， 因 为 在 过 去 10 年 中 ， 软 件 行 业 发 生 了 翻天 和 尾 地 的 变化 。 
回首 2008 年 ， 不 论 手 机 生态 还 是 云 计 算 都 只 是 刚刚 问世 。 亚 马 逊 EC2 于 
2006 年 发 布 ， 谷 歌 的 AppEngine 于 2008 年 发 布 ，Xamarin 由 Mono 项 目 组 
于 2011 年 发 布 ， 而 Docker 直 到 2013 年 才 问 世 。 


对 于 很 多 .NET 程 序 员 来 说 ， 过 去 几 年 中 计算 领域 最 大 的 变化 是 .NET 
Core 的 问世 。.NET Core 是 一 个 跨 平 台 、 开 源 的 框架 ， 并 且 与 其 他 框架 
兼容 《〈 通 过 .NET Standard) 。 它 的 面世 引 人 注 目 ， 而 它 成 为 微软 在 .NET 
领域 投入 最 多 的 项 目 更 令 人 称奇 。 


在 经 历 了 10 年 变迁 之 后 ，C# 依 然 是 .NET 家 族 的 首选 编程 语言 ， 无 论 
是 .NET、.NET Core、Xamarin 还 是 Unity， 都 支持 C#。F# 是 C# 的 一 个 友 
好 的 竞争 对 手 ， 不 过 它 并 未 获得 和 C# 一 样 的 业界 共识 。 


我 从 2002 年 开始 使 用 C# 进 行 开 友 ， 有 时 是 在 工作 中 使 用 ， 有 时 是 出 于 个 
人 的 业余 爱好 。 经 过 这 些 年 的 实践 ， 我 对 于 这 门 语言 的 各 个 细 市 痴迷 不 
已 。 更 重要 的 是 ， 我 十 分 欣 芝 C# 致 力 于 持续 提升 编码 效 灰 。 裹 心 厦 户 我 
的 这 份 热 情 可 以 渗透 并 体现 在 本 书 的 内 容 当 中 ， 并 且 或 舞 读 者 在 C# 开 友 
的 道路 上 不 断 前 行 。 
































致谢 


创作 一 本 书 需要 投入 大 量 时 间 和 精力 。 es A 
的 ， 比 如 这 满 满 一 本 书 的 内 容 ， 但 这 些 看 得 见 的 努力 只 是 冰山 一 角 。 

他 工作 ， 诸 如 编辑 加 工 、 审 校 、 排 版 等 ， 也 都 极其 耗 时 耗 力 。 术 忆 入 人 
在 进行 编辑 加 工 、 校 对 和 排版 之 前 简直 可 以 用 “不 堪 入 目 "来 形容 。 


与 上 一 版 一 样 ， 与 Manning 团 队 合 作 非 常 愉悦 。Richard Wattenberger 为 
本 书 提供 了 很 多 指导 与 建议 ， 他 既 坚 持 图 书 品质 ， 又 能 充分 理解 我 的 工 
作 。 本 书 内 容 经 历 了 多 次 迭代 才 最 终 成 型 〈 尤 其 是 C# 2 ~C# 4 部 分 的 内 
容 做 了 大 量 调整 ) 。 此 外 ， 还 要 感谢 Mike Stephens 和 Marjan Bace 对 本 书 
这 一 版 从 始 至 终 的 文 持 。 


除 结构 调整 外 ， 审 阅 过 程 对 于 保持 内 容 精准 和 清晰 也 全 关 重 要 。Ivan 
Martinovic 负 责 安排 同行 审阅 的 流程 ， 并 获得 了 Ajay Bhosale、Andrei 
Rinea、Andy Kirsch、 Brian Rasmussen、Chris Heneghan、Christos 
Paisios、 Dmytro Lypai、Ernesto Cardenas、Gary Hubbard、Jassel Holguin 
Calderon、Jeremy Lange、John Meyer、Jose Luis Perez Vila、Karl 
Metivier、 Meredith Godar、 Michal Paszkiewicz、 Mikkel Arentoft、 

Nelson Ferrari、Prajwal Khanal、Rami Abdelwahed 和 Willem van 
Ketwicha 给 予 的 重要 反馈 。 感 谢 Dennis Sellinger 的 技术 编辑 ， 以 及 Eric 
Lippert 的 技术 审 校 。 另 外 ， 特 别 感 谢 Eric 对 于 本 书 迄 今 为 止 4 个 版 本 的 页 
献 。 除 了 技术 上 的 修正 ， 他 非凡 的 洞察 力 、 丰 曲 的 经 验 以 及 风趣 的 性 格 
都 对 本 书 影响 至 深 。 


内 容 本 身 很 重要 ， 而 内 容 的 美观 性 同样 重要 。Lori Weidert 负 责 本 书 复杂 

的 生产 流程 ， 为 此 倾注 了 大 量 心 血 。 Sharon Wilkey 娴 熟 且 耐心 地 进行 了 

文字 编辑 。 排版 和 封面 设计 由 Marija Tudor 完 成 。 我 第 一 次 看 到 排版 后 

的 页 Ps 2 言 表 ， 那 种 感觉 就 如 同 努 力 了 数 月 的 一 场 戏剧 
一 次 成 了 


除 直 接 为 本 书 做 出 贡献 的 人 外 ， 我 也 要 感谢 我 的 家 人 在 过 去 几 年 中 对 我 
的 文 持 和 包容 。 我 爱 我 的 家 人 ， 你 们 是 最 棒 的 ， 感 谢 你 们 ! 


最 后 ， 感 谢 关 注 和 阅读 本 书 的 读者 。 如 果 没 有 你 们 ， 以 上 一 切 努 力 都 将 

















付 诺 东 流 。 和 希望 你 们 都 能 从 本 书 中 有 所 收获 。 


大 站 四 
目标 读者 


这 是 一 本 关于 C# 语 言 的 书 。 昌 然 书 中 时 党 需要 讨论 一 些 关 于 运行 时 《〈 负 
Se 





本 书 旨 在 让 读者 尽 可 能 享受 使 用 C# 编 程 的 乐趣 ， 顺 畅 使 用 C#。 把 C# 想 
象 成 一 条 河 ， 而 你 在 河 里 划 着 一 条 皮 划 舰 。 你 对 河流 了 解 得 越 多 ， 随 看 
水 流 划 得 就 越 快 。 即 便 有 时 需要 逆流 而 上 ， 清 楚 水 势 也 有 助 于 更 轻松 地 
抵达 对 岩 ， 而 不 至 于 将 小 船 倾 履 。 


如 果 你 是 有 经 验 的 C# 程 序 员 ， 需 要 进一步 提升 认 知 水 平 ， 那 么 本 书 正 适 
合 你 。 阅 读本 书 不 需要 具备 专家 级 别 的 知识 ， 但 至 少 要 了 解 C# 1 的 基础 
知识 。 我 会 解释 书 中 出 现 的 C# 1 之 后 的 所 有 术语 ， 以 及 一 些 经 溃 混 消 的 
术语 《例如 形 参与 实 参 ) ， 不 过 阅读 本 书 前 你 至 少 应 该 知道 什么 是 类 、 
对 象 等 。 

即使 你 已 经 是 C# 领 域 的 专家 ， 也 能 从 本 书 中 获 益 ， 因 为 它 能 帮助 你 重新 
审视 和 思考 已 熟悉 的 内 容 。 你 可 能 会 发 现 一 些 之 前 没有 注意 过 的 内 容 ， 
我 自己 写 书 时 就 有 类 似 的 体验 。 

如 果 你 是 C# 初 学 者 ， 那 么 本 书 可 能 并 不 适合 你 。 市 面 上 有 很 多 C# 的 入 
0 
0 深 认 知 。 


本 书 的 内 容 设 置 路 线 图 


























的 ， 还 介绍 了 C# 相 关 平 台 和 社区 ， 以 及 本 书 的 内 容 安排 。 
第 二 部 分 重点 介绍 C# 2 到 C# 5。 这 部 分 基本 是 本 书 第 3 版 内 容 的 重 写 与 
浓缩 





。 第 2 章 讨论 C# 2 引入 的 各 项 特性 ， 包 括 泛 型 、 可 空 值 类 型 、 匿 名 方 
法 和 迭代 器 。 

。 第 3 章 前 述 C# 3 的 各 项 特性 如 何 铸 就 LINQ 特 性 。 其 中 最 重要 的 几 个 
特性 是 : lambda 表 达 式 、 匿 名 类 型 、 对 象 初始 化 器 和 查询 表达 式 。 

。 第 4 章 介绍 C# 4 的 各 项 特性 。C# 4 最 大 的 变化 是 引入 了 动态 类 型 ， 
但 可 选 形 参 、 命 名 实 参 、 泛 型 型 变 以 及 如 何 简 化 处 理 COM 等 特性 
也 有 所 变化 。 

。 第 5 章 讨论 C# 5 的 首要 特性 : async/await。 这 一 章 介 绍 了 
async/await 特 性 的 使 用 方法 ， 但 是 基本 不 涉及 异步 特性 的 实现 原 
理 。 男 外 ， 还 介绍 了 C# 后 续 版 本 中 引入 的 对 异步 特性 的 增强 ， 包 括 
自 定 义 task 类 型 和 异步 main 方 法 。 

。 第 6 章 深 入 介绍 编译 器 创建 状态 机 以 处 理 async 方 法 的 原理 ， 完 成 了 
对 async/await 特 性 的 介绍 。 

。 第 7 章 简 单 讨 论 C# 5 中 除 async/await 外 的 一 些 新 特性 。 第 6 章 是 本 书 
最 “ 便 核 ” 的 一 章 ， 第 7 半 相 当 于 和 餐 后 甜点 。 


第 三 部 分 介绍 C# 6 的 各 项 特性 。 


。 第 8 章 介 绍 表 达 式 主体 成 员 。 使 用 表达 式 主体 成 员 ， 可 以 在 声明 简 
单 属性 和 方法 时 省 略 很 多 枯燥 的 样板 代码 。 此 外 ， 这 一 章 还 介绍 了 
自动 实现 属性 的 改进 。 这 些 都 是 关于 如 何 精 简 代 码 的 。 

。 第 9 章 介绍 C# 6 中 的 字符 串 相 关 特 性 : 内 揪 字 符 串 字面 量 以 及 
nameof 操 作 符 。 尽 管 这 两 个 特性 只 是 创建 字符 串 的 新 方式 ， 但 它们 
是 C# 6 特性 中 便捷 易 用 的 典范 。 

。 第 10 章 介绍 C# 6 的 其 余 特性 ， 它 们 并 没有 共同 的 主题 ， 只 是 有 助 于 
保持 代码 简洁 。 在 这 些 特性 中 ， 空 值 条 件 运算 符 的 用 途 应 该 更 广 
泛 。 它 简化 了 可 能 涉及 nul1 值 的 表达 式 ， 从 而 避免 了 


NullReferenceException。 
第 四 部 分 重点 讨论 C#7 (一 直到 C# 7.3) ， 并 且 展 望 C# 的 未 来 。 


。 第 11 章 介绍 元 组 特性 的 引入 ， 讲 解 用 于 实现 元 组 的 valueTuple 类 型 
家 族 。 








第 12 章 介绍 分 解 和 模式 匹配 。 二 者 都 是 看 待 现 有 数据 的 简洁 方式 。 
尤其 是 在 switch 语 句 中 使 用 模式 匹配 ， 可 以 简化 在 不 适合 使 用 继承 
的 情况 下 对 不 同 值 类 型 的 处 理 。 

第 13 章 重点 介绍 按 引 用 传递 及 其 相关 特性 。C# 自 一 开始 就 提供 了 

ref 参 数 ， 但 C# 7 引入 了 许多 新 特性 ， 比 如 ref return 和 ref 局 部 变 

量 。 这 些 特 性 的 主要 功能 是 通过 减少 复制 提升 效率 。 

第 14 章 介绍 C# 7 的 一 些小 特性 ， 这 些 特性 都 用 于 简化 代码 。 我 个 人 
最 喜欢 局 部 方法 、out 变 量 和 default 字 面 量 。 

第 15 章 展望 C# 的 未 来 。 我 在 撰写 本 章 时 使 用 的 是 C# 8 预览 版 ， 意 在 
研究 可 空 引 用 类 型 、switch 表 达 式 、 模 式 匹 配 的 增强 、range， 以 及 
如 何 进一步 将 异步 集成 到 核心 语言 特性 中 。 这 一 章 的 内 容 都 是 推测 
性 的 ， 和 希望 可 以 激发 读者 的 探究 欲 。 


最 后 ， 附 录 提 供 了 一 个 便捷 的 索引 ， 可 用 于 查找 每 个 C# 版 本 所 对 应 的 特 
性 ， 以 及 它们 的 运行 时 和 framework 要 求 ， 这 些 要 求 限制 了 可 以 使 用 这 
些 特 性 的 上 下 文 环 境 。 


建议 读者 按照 顺序 阅读 本 书 《〈 至 少 第 一 次 阅读 时 如 此 ) ， 因 为 后 面 的 内 
容 是 以 前 面 的 内 容 为 基础 的 ， 如 果 不 按 照 顺序 阅读 ， 可 能 会 遇 到 一 些 困 
难 。 完 整 阅读 之 后 ， 可 以 将 其 用 作 参 考 书 ， 在 需要 查阅 特定 内 容 或 者 研 
究 特 定 细 节 时 ， 随 时 参阅 相关 主题 。 


天 于 代码 


本 书包 含 了 很 多 代码 示例 ， 有 些 是 “代码 清单 x-x? 的 形式 ， 有 些 则 巷 于 
文本 内 容 中 。 不 论 哪 种 代码 ， 本 书 都 使 用 特殊 的 格式 将 其 与 文本 区 分 
开 。 有 时 代码 会 加 粗 ， 以 突出 显示 与 之 前 的 步骤 不 同 之 处 ， 例 如 在 现 有 
代码 行 中 添加 新 特性 时 。 


书 中 很 多 源码 重新 调整 了 格式 ， 通 过 换行 和 增加 缩 进来 适应 书页 排版 。 
在 个 别 情况 下 ， 代 码 清单 中 会 有 承接 上 行 的 标记 (ww) 。 此 外 ， 书 中 的 
代码 注释 主要 用 于 解释 说 明 重 要 之 处 。 

本 书 中 的 示例 代码 可 以 从 出 版 丙 的 网 站 下 载 1， 网 址 

为 : https:/www.manning.com/books/c-sharp-in-depth-fourth-edition。 读 者 


需要 安装 .NET Core SDK(2.1.300 或 更 高 版 本 ) 来 构建 示例 代码 。 一 些 
示例 需要 Windows 桌 面 .NET Framework ( 当 涉 及 Windows Forms 或 者 





























COM 时 ) ， 不 过 对 于 大 部 分 示例 ， 使 用 .NET Core 即 可 。 虽 然 我 使 用 
Visual Studio 2017〈 社 区 版 ) 来 开发 示例 ， 但 读者 也 可 以 选用 Visual 
Studio Code。 


1 你 可 以 直接 访问 本 书 中 文 版 页 面 ， 下 载 本 书 示例 代 
码 : https:/www.ituring.com.cn/book/2689， 也 可 在 此 查看 或 提交 勘误 。 
一 一 编者 注 


本 书 论坛 


购买 本 书 ， 可 以 免费 访问 Manning Publications 的 网 络 论坛 。 读 者 可 以 在 
论坛 上 发 表 对 本 书 的 评论 ， 提 出 技术 问题 并 获得 作者 或 者 其 他 用 户 的 帮 
助 ， 网 址 为 : https:/forums.manning.comy/forums/c-sharp-in-depth-fourth- 
edition。 也 可 以 访问 https:/forums.manning.com/forums/about 来 了 解 有 关 
Manning 论 坛 和 行为 准则 的 更 多 信息 。 


Manning 承 诺 为 读者 提供 一 个 平台 ， 供 读者 之 间 以 及 读者 和 作者 之 间 进 
行 有 意义 的 交流 ， 但 无 法 保证 作者 在 论坛 上 的 参与 度 ， 因 为 作者 对 论坛 
的 贡献 完全 是 无 偿 和 自愿 的 。 建 议 读者 尽 可 能 向 作者 提出 一 些 具 有 挑战 
性 的 问题 以 引起 他 的 兴趣 。 只 要 书 仍 在 发 行 ， 你 就 可 以 在 出 版 商 网 站 上 
访问 论坛 和 先前 所 讨论 的 内 容 。 


其 他 在 线 资 源 


互联 网 上 关于 C# 的 学 习 资 源 不 计 其 数 ， 下 面 是 我 认为 最 有 帮助 的 一 些 资 
源 。 当 然 ， 读 者 在 搜索 时 也 会 发 现 更 多 有 用 信息 。 


微软 .NET 文 档 

.NET API 文 档 

C# 语 言 设 计 代 码 仓库 
Roslyn 代 码 仓库 

C# ECMA 标 准 

Stack Overflow 


电子 书 

















扫描 如 下 二 维 码 ， 即 可 购买 本 书 中 文 版 电子 版 。 


关于 作者 


我 是 基因 -斯 基 特 ， 一 名 就 职 于 谷歌 (伦敦 办 公 室 〉 的 软件 工程 师 。 我 
现 阶 段 的 工作 是 为 谷歌 云 平 台 开 发 .NET 客 户 端 库 。 我 个 人 对 于 C# 语 言 
的 热爱 与 供职 谷歌 的 愿望 因此 完美 地 结合 在 了 一 起 。 此 外 ， 我 还 是 
ECMA 的 会 议 召 集 人 ， 负 责 C# 标 准 化 工作 ， 也 是 .NET Foundation 的 谷歌 
公司 代表 。 


可 能 很 多 读者 对 我 的 了 解 主要 来 自 于 我 在 Stack Overflow (一 个 开发 者 
问答 网 站 ) 上 所 做 的 贡献 。 我 也 热 训 于 在 各 种 会 议 、 用 户 组 以 及 博客 上 
发 表演 讲 。 这 些 活动 有 一 个 共同 的 特征 一 可 以 和 其 他 开发 者 互动 。 这 
也 是 对 我 个 人 而 言 最 佳 的 学 习 方 式 。 


我 还 有 一 项 或 许 不 太 寻 篆 的 爱好 ， 那 束 是 喜欢 钻研 日 期 和 时 间 。 这 一 爱 

好 基本 体现 在 我 的 个 人 项 目 Noda Time 中 了 。Noda Time 是 一 个 适用 

于 .NET 的 日 期 与 时 间 库 ， 本 书 也 会 使 用 一 些 来 自 Noda Time 的 代码 示 

例 。 抛 开动 手 编码 的 乐趣 不 谈 ， 单 是 时 间 问 题 本 号 就 是 一 个 充满 趣味 性 

Hs es 0 0 
里 影 。 


其 实 是 本 书 的 编辑 希望 我 能 够 介绍 一 下 个 人 基本 情况 ， 以 证 明 我 有 资格 
撰写 这 本 书 ， 但 这 并 不 意味 着 书 中 的 内 容 没 有 任何 距 漏 。 谦 虚 的 品质 对 
于 软件 工程 师 来 说 至 关 重 要 。 我 只 是 一 个 普通 人 ， 也 会 犯错 。 编 译 器 的 
行为 也 并 不 会 因 使 用 者 号 份 不 同 而 不 同 。 


本 书 尽 可 能 区 分 C# 语 言 的 客观 事实 和 我 的 个 人 看 法 。 对 于 客观 事实 部 
分 ， 勤 盏 的 技术 审 稳 人 已 经 尽 可 能 消除 了 错误 ， 不 过 从 之 前 版 本 的 经 验 
来 看 ， 难 免 有 错误 遗留 。 至 于 个 人 看 法 部 分 ， 我 的 观点 可 能 与 读者 的 观 
扩大 相 径 姓 。 不 过 没有 关系 ， 读 者 可 以 自由 取 用 。 














关于 封面 插图 


本 书 封面 插图 的 标题 是 “音乐 家 ”。 插 图 来 自 一 本 奥斯曼 帝国 的 服饰 画 

册 ， 该 画册 由 伦敦 老 邦 德 街 的 William Miller 于 1802 年 1 月 1 日 出 版 。 画 册 
的 摩 页 现 已 丢失 ， 因 此 很 难 推 疡 它 准确 的 创作 时 间 。 该 画册 的 目录 同时 
使 用 英语 和 法 语 标 识 插图 ， 每 幅 揪 图 上 都 有 两 位 创作 者 的 名 字 。 如 果 他 
们 发 现 自己 的 作品 出 现在 200 年 后 的 计算 机 编程 书 的 封面 上 ， 一 定 会 大 


吧 一 慰 。 


Manning 出 版 社 的 一 位 编辑 在 位 于 曼哈顿 西 26 街 “Garage” 的 古董 跳 阳 市 
场 买 到 了 这 本 画册 。 卖 主 是 一 位 住 在 土耳其 安卡拉 的 美国 人 人， 交易 时 间 
是 那天 他 准备 收 摊 的 时 候 。 这 位 编辑 号 上 球 的 现金 不 够 买 下 这 本 画册 ， 
并 且 卖 主 礼 钥 地 拒绝 了 他 使 用 信用 卡 和 文 票 文 付 的 请 求 。 而 且 卖 主 当晚 
就 要 飞 回 安卡拉 ， 交 易 好 像 无 望 了 。 该 怎么 办 呢 ? 两 个 人 最 后 通过 握手 
约定 的 老 派 君子 协议 解决 了 问题 。 卖 主 提议 通过 银行 转账 付款 ， 而 编辑 
在 纸 上 记 下 了 收 款 银 行 账户 信息 ， 随 后 带 走 了 男 册 。 不 用 说 ， 第 二 天 编 
辑 就 给 卖主 打 了 丈 。 他 很 感谢 这 位 陌生 人 无 条 件 的 信任 。 这 让 我 们 回忆 
起 了 很 久 以 前 的 美好 时 代 。 


Manning 出 版 社 用 两 个 世纪 前 丰 定 多 彩 的 地 方 生 活 作为 图 书 封 面 的 素 
材 ， 以 此 赞美 计算 机 行业 的 创造 性 、 主 动 性 和 趣味 性 ， 用 画册 中 的 图 片 
带 读 者 领略 那个 时 代 的 风土 人 情 。 

















第 一 部 分 “CH# 背 景 介 绍 


还 记得 在 我 大 学 的 一 党 计 算 机 科学 课 上 ， 有 位 同学 纠正 了 讲师 在 黑板 上 

写 的 一 处 细节 。 当 时 讲师 有 些 不 悦 ， 他 说 道 : “和 是， 我 知道 。 我 这 是 在 

简化 问题 ， 先 隐 去 一 些 细节 ， 目 的 是 之 后 展示 更 大 的 图 景 。"” 硕 望 本 书 

| 
分 Eo 


本 书 大 部 分 内 容 旨 在 深入 探 客 C# 语 言 的 细节 ， 有 时 甚至 会 讨论 一 些 细 术 
末节 。 在 开始 探讨 细节 之 前 ， 第 1 章 会 先 回 顾 C# 的 历史 ， 并 讨论 C# 如 何 
适应 不 断 变 化 的 外 部 环境 。 

在 正式 开始 讲解 之 前 ， 本 书 会 为 读者 提供 一 些 代码 示例 作为 热 旱 。 在 这 
个 阶段 ， 代 码 细 市 并 不 重要 ， 重 点 是 讨论 C# 开 发 的 思想 和 主题 ， 确 定 基 
本 的 思维 框 保 ， 为 之 后 学 习 具 体 实现 做 好 准备 。 


话 不 多 说 ， 我 们 开始 吧 ! 




















第 1 章 大浪淘沙 
本 章 内 容 概览 


。 C# 如 何 通过 多 方位 快速 演化 提升 开发 效率 ; 
。 如 何 根据 C# 的 最 新 特性 选择 最 小 版 本 号 ; 
。 C# 如 何不 断 文 持 更 多 运行 平 合 ; 

。 开放 互动 的 C# 社 区 如 何 助力 开发 人 员 ; 

。 本 书 针对 C# 新 旧版 本 的 详 略 安排 。 


要 从 C# 中 挑选 出 一 个 最 有 趣 的 特性 ， 疏 介 并 非 易 事 。 有 些 特 性 耀眼 生 
伦 ， 却 少 有 用 武之 地 ， 有 些 特性 伴 头 重要， 却 早已 为 开 及 人 员 耳 熟 能 
详 ; 而 像 async/await 这 种 出 类 拔 菜 的 机 制 ， 又 非 三 言 两 语 就 能 描述 得 清 
楚 。 下 面 言 归 正 传 ， 先 来 回顾 C# 这 些 年 的 演化 之 路 。 


1.1 一 门 与 时 俱 进 的 语言 


本 书 前 几 版 都 用 一 个 贯 罕 始 终 的 例子 来 展示 截至 当时 C# 语 言 版 本 的 发 展 
历程 。 这 种 展现 方式 虽然 阅读 起 来 更 具 趣 味 性 ， 但 是 已 经 无 法 沿用 了 ， 
因为 只 有 大 型 应 用 程序 才 勉强 能 用 上 C# 的 所 有 新 特性 ， 而 书页 所 能 容纳 
的 小 段 代码 只 够 展示 一 小 部 分 特性 。 


为 此 ， 本 章 只 遂 选 Ci 版 本 演化 过 程 中 最 重要 的 几 个 方面 来 讲述 ， 并 只 针 
对 部 分 改进 的 特性 给 出 简短 的 示例 代码 。 我 并 不 想 连 篇 累 租 地 讲授 和 罗 
列 C# 的 特性 。 本 章 旨 在 回顾 读者 已 知 的 特性 ， 同 时 梳理 其 他 未 知 特性 。 


熟悉 其 他 语言 的 一 些 读者 ， 可 能 会 感觉 C# 的 荣 些 新 特性 就 是 从 别处 借鉴 
过 来 的 。 没 错 ， C# 设 计 团队 长 期 以 来 都 在 不 遗 余力 地 从 其 他 语言 吸纳 优 
秀 想 法 ， 努 力 营 造 出 一 种 “宾至如归 ”的 感 党 。 妙 不 可 言 吧 ? 说 到 这 里 ， 
不 得 不 提 一 下 F# 这 门 语言 ， 可 以 说 C# 的 很 多 特性 受到 了 F# 的 局 发。 


说 明 ”从 F# 中 受益 最 多 的 可 能 不 是 F# 开 发 人 员 ， 而 是 C#。 这 并 不 
是 贬低 F# 作 为 一 种 语言 本 身 的 价值 ， 也 不 是 暗示 不 应 该 直接 使 用 
它 。 但 是 ， 当 前 C# 社 区 的 规模 远 超 F# 社 区 。C# 社 区 对 从 F# 社 区 所 
获 的 启发 当 致 以 敬意 。 




















人 (type system ) 一 一 作为 开 


1.1.1 类 型 系统 一 一 全 能 型 助手 


C# 目 诞生 之 日 起 就 一 直 是 一 门 静 态 类 型 语言 。 开 发 人 员 需 要 在 代码 中 明 
确 给 出 变量 、 参 数 及 返回 值 的 类 型 等 。 将 参数 和 返回 值 的 数据 形态 描述 
得 越 精确 ， 编 译 器 就 越 有 助 于 规避 错误 。 


当 所 构建 的 应 用 程序 的 规模 不 断 增 长 时 ， 这 一 点 更 加 考 良 置疑。 静态 类 
型 语言 的 这 种 优势 ， 对 于 那些 简短 的 代码 也 许 并 不 明显 ， 但 是 随 着 代码 
量 的 增加 ， 代 码 能 否 简 明 有 效 地 传达 信息 就 变 得 印发 重要 了 。 昌 然 通过 
编写 文档 也 能 做 到 这 一 点 ， 但 是 使 用 静态 类 型 能 够 让 开发 人 员 以 机 顺 可 
读 的 方式 来 实现 。 


随 痢 C# 语 言 的 演化 ， 其 类 型 系统 能 够 提供 越 来 越 精细 的 描述 方式 。 其 中 
最 直观 的 例子 就 是 泛 型 (generic) 。 用 C#1 写 出 的 代码 如 下 所 示 : 


public class Bookshelf 








public IEnumerable Books { get { ... } } 





Books 这 个 序列 中 每 个 元 素 的 类 型 是 什么 ， 不 得 而 知 ， 这 是 因为 类 型 系 
统 无 法 告诉 我 们 ， 但 是 用 C# 2 描述 起 来 就 高 效 得 多 了 : 

public class Bookshelf 

{ 


public IEnumerable<Book> Books { get { ... }} 


此 外 ，C# 2 还 引入 了 可 空 值 类 型 (nullable value type) 。 利 用 它 可 以 有 
效 表示 未 定 的 变量 值 ， 从 而 摆脱 对 魔 数 〈 把 -1 用 作 集 合 索引 ， 或 者 
用 DateTime.Minvalue 表 示 日 期 等 ) 的 使 用 。 


到 了 C# 7， 使 用 者 还 可 以 采用 readonly struct 这 样 的 声明 ， 将 自 定义 结 
构 体 声明 为 不 可 变 类 型 。 此 项 特性 原本 则 在 提升 编译 器 生成 代码 的 效 
率 ， 但 它 也 有 助 于 开发 人 员 更 准确 地 表达 代码 意图 。 


C# 8 还 计划 加 入 可 空 引 用 类 型 Cnullable reference type) ， 以 期 进一步 提 





升 代码 的 信息 表达 能 力 。 截 至 目前 ，C# 还 没有 提供 一 种 用 于 描述 引用 类 
型 (无论 是 返回 值 、 参 数 ， 还 是 局 部 变量 ) 是 否 为 空 的 机 制 。 在 这 种 情 
况 下 ， 如 末 编 码 不 够 严谨， 就 容易 出 错 ; 如 果 编 码 太 过 座 愤 ， 叉 会 因为 
需要 增加 校 验 而 使 代码 变 得 爱 肿 。 两 者 都 不 太 理 想 。C# 8 假设 任何 没有 
显 式 声明 为 可 空 的 值 都 为 非 可 空 值 ， 例 如 下 面 这 个 方法 声明 : 


string Method(string x, string? y) 


该 方法 参数 的 类 型 很 明确 : x 是 非 可 空 值 ，y 则 是 可 空 值 。 方 法 的 返回 值 
《没有 ?符号 ) 表示 函数 的 返回 值 也 是 非 可 空 的 。 


C# 类 型 系统 中 的 其 他 一 些 变 动 则 是 从 小 处 着 手 ， 更 关注 单个 方法 的 实现 
问题 ， 而 非 大 型 系统 各 组 件 之 间 的 交互 。C# 3 引入 了 匿名 类 型 
(anonymous type) 和 隐 式 局 部 变量 (var) ， 二 者 用 于 解决 某 些 静态 类 
型 语言 的 缺陷 : 代码 元 余 。 对 于 一 个 仅 在 单一 方法 中 使 用 的 数据 形态 ， 
如 果 要 为 其 专门 创建 额外 的 数据 类 型 ， 不 协 于 牛刀 杀 鸡 。 而 使 用 匿名 类 
型 的 好 处 就 在 于 ， 在 保持 静态 类 型 语言 优势 的 同时 ， 可 以 清晰 简洁 地 描 
述 数据 形态 。 

var book = new { Title = "Lost in the Snow", Author = "Holly Webb 


string title = book.Title; (本 行 及 以 下 1 行 ) 编译 器 依然 会 检查 名 称 和 类 型 
string author = book.Author ; 


匿名 类 型 主要 用 于 LINQ 碍 询 语 句 。 不 过 即便 没有 LINQ， 为 单一 方法 专 
门 创建 数据 类 型 这 种 做 法 也 不 太 可 取 。 


同样 ， 如 果 调 用 了 人 类 型 的 构造 方法 ， 就 没有 必要 在 同一 条 语句 中 显 式 
声明 该 变量 的 类 型 了 。 下 面 两 种 声明 方式 哪个 更 简洁 一 目 了 然 : 


Dictionary<string, string> map1 = new Dictionary<string, string>( 
































var map2 = new Dictionary<string, string>(); <----- 隐 式 类 型 


隐 式 类 型 在 处 理 匿名 类 型 时 不 可 或 缺 ， 在 处 理 普 通 类 型 时 ， 其 重要 性 也 
日 益 凸 显 。 另 外 ， 读 者 需要 重点 区 分 隐 式 类 型 〈implicit typing) 和 动态 
类 型 (dynamic typing) 这 两 个 概念 。 注 意 以 上 代码 中 的 变量 map2， 它 
属于 静态 类 型 ， 只 是 没有 显 式 地 写 出 其 类 型 而 已 。 


不 过 ， 匿 名 类 型 的 作用 域 仪 限 于 单个 代码 块 ， 无 法 将 其 用 作 方 法 的 参数 
或 返回 值 。C# 7 引入 了 元 组 〈tuple) 的 概念 。 元 组 是 一 种 值 类 型 变量 ， 


它 可 以 有 效 地 组 织 变量 。 元 组 的 framework 支 持 相 对 比较 简单 ， 但 还 需 
要 额外 的 语言 文 持 来 实现 对 元 系 进行 命名 。 可 以 使 用 元 组 来 瞧 代 前 文中 
的 匿名 类 型 


var book = (title: "Lost in the Snow", author: "Holly Wwebb"); 
Console.writeLine(book.title); 








用 元 组 蔡 代 匿名 类 型 的 用 法 只 适用 于 部 分 场合 ， 其 好 处 之 一 是 元 组 可 以 
用 作 方 法 的 参数 和 返回 值 。 目 前 我 个 人 建议 将 元 组 的 使 用 范围 尽量 限制 
在 内 部 API 中 ， 不 要 对 外 骏 串 ， 因 为 元 组 只 是 对 值 进行 简单 的 组 合 ， 并 
没有 对 其 进行 封闭。 所 以 在 我 看 来 ， 元 组 只 是 C# 实 现 层面 的 小 改进 ， 而 
非 整体 设计 层面 的 改进 。 


讲 到 这 里 顺便 提 一 下 ，C# 8 可 能 会 引入 一 种 新 类 型 一 一 记录 类 型 
(record type)。 从 记录 类 型 的 最 简 形 式 来 看 ， 它 在 某 种 程度 上 属于 “ 具 
名 的 匿名 类 型 "?。 同 匿名 类 型 一 样 ， 记 录 类 型 有 助 于 消除 样板 代码 ， 此 
外 它 还 兼备 普通 类 的 行为 特征 。 敬 请 关注 ! 


1.1.2 ”代码 更 简 清 


让 开发 人 员 能 更 简洁 、 更 精准 地 通过 代码 表达 意图 ， 是 贯穿 于 C# 各 项 新 
特性 中 一 个 永恒 的 主题 。 从 前 面 讲 到 的 匿名 类 型 就 不 难看 出 ， 类 型 系统 
对 代码 的 简洁 之 道 页 献 颇 多 ， 其 他 很 多 特性 当然 也 腔 不 壕 色 。 关 于 简化 
代码 的 各 种 论调 ， 读 者 可 能 早已 不 胜 其 烦 ， 特 别 是 天 于 新 特性 推出 后 ， 
又 可 以 删 减 哪 些 代 码 。 利 用 好 C# 的 这 些 新 特性 ， 可 以 减少 形式 化 代码 、 
去 掉 样 板 化 代码 、 删 减 额 外 代码 。 总 的 来 说 ， 就 是 一 条 原则 一 一 消灭 元 
余 。 这 些 见 余 代 码 没 有 错 ， 只 是 碍 眼色 多 余 而 已 。 束 精简 代码 而 言 ，C# 
在 以 下 几 方 面 均 有 建树 。 
1. 构造 与 初始 化 
首先 考虑 对 象 构造 和 初始 化 的 方式 。 委 托 (delegate) 应 该 是 演化 
最 多 而 且 最 快 的 一 项 特性 了 。 在 C# 1 中， 需要 先 写 一 个 委托 可 以 指 
问 的 方法 ， 然 后 再 写 一 大 段 代码 来 创建 委托 。 例 如 ， 要 为 一 个 按钮 
的 click 事 件 订 阅 一 个 新 的 事件 处 理 方法 ，C# 1 代码 如 下 所 示 : 


button.Click += new EventHandler(HandleButtonClick); <------ 




















C# 2 引入 方法 组 转换 (method group conversion) 和 匿名 方法 


(anonymous method) 后 ， 就 可 以 采用 如 下 形式 来 保 
存 HandleButtonclick 方 法 了 了: 


button.Click += HandleButtonClick; <------ C# 2 


如 果 click 处 理 方法 比较 简单 ， 也 可 以 只 写 一 个 匿名 方法 ， 不 需要 
再 单独 创建 方法 : 


button.Click += delegate { MessageBox.Show("Clicked!"); }; <- 


另外 ， 匿 名 函数 的 闭 包 (closure) 特性 还 有 额外 的 好 处 : 在 匿名 函 
数 中 访问 其 所 在 上 下 文 的 局 部 变量 。 不 过 自从 C# 3 推出 lambda 表 达 
式 之 后 ， 匿 名 函数 已 渐渐 失宠 ， 因 为 lambda 表 达 式 几乎 具备 匿名 水 
数 的 所 有 优 长 ， 而 且 它 的 语法 更 简洁 。 


button.Click += (sender, args) => MessageBox.Show("Clicked!") 


说 明 ”在 本 例 中 ，Lambda 表 达 式 比 匿名 方法 长 ， 因 为 匿名 方 
法 使 用 了 Lambda 表 达 式 不 具备 的 一 个 特性 ， 不 提供 参数 列表 
从 而 忽略 参数 。 


前 文 之 所 以 采用 事件 处 理 作为 委托 的 示例 ， 是 因为 C# 1 中 事件 处 理 
是 委托 的 主要 用 途 ;， 而 在 C# 1 之 后 ， 委 托 还 被 灵活 应 用 于 更 多 场 
景 ， 其 中 最 具 代 表 性 的 就 是 LINQ。 


LINQ 所 采用 的 对 象 初始 化 器 和 集合 初始 化 器 便利 了 初始 化 操作 。 
使 用 初始 化 器 ， 在 创建 新 对 象 或 者 集合 时 ， 就 可 以 仅 在 一 个 表达 式 
内 完成 对 属性 或 者 元 素 的 批量 赋值 。 这 里 借用 第 3 章 的 一 段 示例 代 
码 来 说 明 ， 这 样 会 比 文字 描述 有 效 得 多 。 曾 经 的 代码 是 : 


Var customer = new Customer(); 
customer.Name = "Jon"; 
customer.Address = "UK"; 

var item1i = new orderItem( ) ; 
itemi.ItemId = "abcd123"，; 
itemi.Quantity = 1; 

var item2 = new OrderItem( ) ; 
item2.ItemId = "fghi456"; 
Item2 ,Quantity = 2; 

var order = new Order(); 
order .OrderId = "xyz"; 
order.Customer = customer; 




















order.Items.Add(item1); 
order.Items.Add(item2); 


采用 C# 3 引入 的 对 象 初始 化 器 和 集合 初始 化 器 来 写 ， 更 清晰 明了 : 
var order = new Order 


OrderId = "xyz", 
Customer = new Customer { Name = "Jon", Address = "UK" }, 
Items = 
{ 
new OrderIitem { ItemId 
new OrderIitem { ItemId 


"abcd123", Quantity 
"fghi456", Quantity 


} 
}; 


对 于 以 上 两 段 代 码 ， 该 者 不 必 深 完 其 细节 ， 只 需 重 点 感受 第 2 段 代 
码 所 展现 的 简洁 即 可 。 








. 方法 与 属性 声明 


目 动 实 现 的 属性 是 C# 代 码 简化 中 最 显著 的 特性 之 一 。 此 项 特性 始 
于 C# 3， 并 在 后 续 版 本 中 不 断 强化 。 例 如 由 C# 1 实现 的 以 下 代码 : 


private string name; 
public string Name 





get { return name; } 
set { name = value; } 


} 
如 果 采 用 上 自动 实现 的 属性 ， 则 仅 需 一 行 代码 : 
public string Name { get; Set， } 


此 外 ，C# 6 引入 的 表达 式 主 体 成 员 (expression-bodied member) 进 
一 步 降低 了 C# 语 言 的 复杂 度 。 假 设 有 一 个 封装 了 string 集 合 的 类 ， 
该 集合 的 count 和 GetEnumerator() 这 两 个 成 员 ， 在 C# 6 以 前 需要 写 
成 如 下 形式 : 


public int Count { get { return list.Count; } } 








public IEnumerator<string> GetEnumerator() 


{ 


return list.GetEnumerator(); 


这 个 例子 生动 地 展示 了 什么 叫 作 “ 例 行 公 事 * 般 的 代码 ， 这 种 写法 仪 
仅 是 为 了 满足 语法 要 求 。 有 了 C# 6， 就 可 以 使 用 => 标 记 作 为 表达 式 
主体 成 员 ， 大 幅 简 化 代码 : 


public int Count => list.Count; 





public IEnumerator<string> GetEnumerator() => list.GetEnumera 
如 今 => 符 号 已 经 广泛 应 用 于 lambda 表 达 式 中 了 。 

表达 式 主体 成 员 增 强 了 代码 的 可 读 性 ， 实 在 令 人 赞叹 。 尽 管 只 是 一 
种 主观 感受 ， 但 我 确实 难以 掩饰 对 它 的 喜爱 之 情 。 关 于 字符 串 ，C# 


新 增 了 一 项 名 为 字符 串 内 插 《string interpolation ) 的 改进 。 我 个 人 
对 字符 串 内 插 的 使 用 频率 之 高 远 超 预 期 。 





. 字符 串 处 理 
C# 中 的 字符 串 处 理 总 共 涉 及 3 大 方面 改进 。 


o C# 5 引入 了 调用 方 信息 特性 (caller information attribute) 。 通 
过 这 项 特性 ， 编 译 器 可 以 将 方法 名 和 文件 名 自动 填充 到 参数 值 
中 。 无 论 是 用 于 持久 化 日 志 还 是 临时 性 测试 ， 这 项 特性 对 程序 
诊断 大 有 帮助 。 

o C# 6 引入 了 nameof 运 算 符 ， 用 于 获取 变量 、 类 型 、 方 法 或 成 员 
的 名 字 。 常 言 道 “ 手 握 nameof 运 算 符 ， 代 码 重 构 不 发 居 。” 

o C# 6 引入 了 内 插 字 符 串 字面 量 (interpolated string literal) ， 极 
尽管 它 并 不 算 一 个 全 新 的 


篇 幅 所 限 ， 这 里 只 针对 最 后 一 个 特性 给 出 相关 示例 。 将 变量 、 属 
性 、 函 数 返 回 值 等 用 于 创建 字符 串 是 第 见 需 求 ， 可 用 于 记录 日 志 、 
为 用 户 所 做 错 误 信 息 (假设 没有 属地 化 需求 ) 、 构 建 寞 常 信息 ， 等 




















举 一 个 取 自 我 的 Noda Time 项 目的 例子 : 用 户 通过 ID 碍 找 日 历 系 
统 ， 如 果 该 ID 不 存在 ， 则 代码 抛 出 一 个 keyNotFoundException。 在 
C# 6 之 前 ， 代 码 写 法 如 下 : 


throw new KeyNotFoundException( 
"No calendar system for ID" + id + " exists"); 


或 者 直接 调用 字符 品格 式 化 方法 : 


throw new KeyNotFoundException( 
string.Format("No calendar system for ID {0} exists", id) 


说 明 1.4.2 节 有 关于 Noda Time 的 介绍 ， 理 解 本 例 不 需要 了 解 
1 


而 到 了 C#6， 由 于 有 了 内 插 字 符 串 字面 量 ， 只 需 把 id 这 个 变量 值 包 
含 在 字符 串 中 即 可 ; 


throw new KeyNotFoundException($"No calendar System for ID {i 


尽管 不 是 什么 大 的 改动 ， 但 这 项 特性 已 然 深 入 我 的 日 营 编 码 ， 变 得 
不 可 或 缺 了 。 


前 面 提 到 的 这 些 特性 ， 都 是 助力 开发 人 员 精 简 代 码 的 精华 部 分 。 除 
此 以 外 ， 其 他 优秀 的 特性 还 包括 C# 6 中 的 using static 指 令 和 空 值 
条 件 运 算 符 ，C#7 中 的 模式 匹配 、 分 解 、out 变 量 等 。 不 过 没有 必 
要 逐个 版 本 地 曾 述 这 些 特 性 ， 下 面 重 点 探究 一 个 堪 称 革命 性 改进 的 
新 特性 : LINQ。 


1.1.3 使 用 LINQ 简 化 数据 访问 


如 果 问 程序 员 “ 你 喜欢 C# 的 什么 ”， 提 到 LINQ 的 估计 不 在 少数 。 前 面 介 
ee 不 过 LINQ 的 核心 特性 还 是 查询 表达 式 。 参 
0 下 代码 : 


var offers = 
from product in db,.Products 
where product.SalePrice <= product.Price / 2 
orderby product.SalePrice 
select new { 
product.Id, product.Description, 





product.SalePrice, product.Price 


以 上 代码 和 那些 “传统 ”代码 可 以 说 风格 包 寞 。 难 以 想象 如 果 穿 越 回 2007 
年 ， 去 跟 一 个 还 在 使 用 C# 2 的 程序 员 展 示 这 段 代码 会 是 怎样 的 场景 : 你 
会 告诉 他 这 段 代码 文 持 编 译 时 检查 以 及 智能 提示 ， 还 会 产生 一 次 高 效 的 
数据 库 碍 询 操作 。 另 外 ， 这 种 特殊 的 语法 对 普通 集合 同样 适用 。 


LINQ 使 用 表达 式 树 来 完成 进程 外 数据 的 查询 操作 。 表 达 式 树 把 代码 当 
作 数 据 进 行 处 理 ，LINQ Provider 可 以 分 析 代 码 ， 并 将 其 转换 为 SQL 或 其 
他 查询 语言 。 其 实 我 个 人 很 少 用 到 这 项 出 色 的 特性 ， 因 为 我 很 少 需 要 同 
SQL 数据 库 交 互 ， 但 是 我 需要 使 用 查询 表达 式 或 者 lambda 表 达 式 来 处 理 
内 存 集 合 ， 所 以 使 用 LINQ 的 频 度 也 很 高 。 


对 于 C# 程 序 员 来 说 ，LINQ 绝 不 仪 仅 是 一 个 新 “工具 ”， 它 还 驱动 着 我 们 
突破 数据 访问 的 限制 ， 以 函数 式 编程 的 角度 看 待 数 据 转 换 过 程 。LINQ 
对 开 及 人 员 的 函数 式 思维 起 到 了 抛砖引玉 的 作用 ， 开 发 人 员 则 以 此 为 收 
机 把 这 一 思维 应 用 得 更 加 广泛 。 


尽管 C# 4 对 动态 类 型 做 出 了 天 翻 地 有 履 的 改进 ， 可 是 要 说 到 对 程序 员 影 响 
之 深远 ， 还 是 首 推 LINQ。 而 等 到 C# 5 出 场 ， 它 凭借 异步 特性 再 一 次 令 
C# 改 头 换 面 。 














1.1.4 ”异步 





异步 对 于 主流 编程 语言 一 直 是 个 难题 ， 而 很 多 小 众 语言 目 设 计 之 初 就 充 
分 考虑 了 异步 机 制 的 设计 ， 一 些 函 数 式 语言 更 是 将 异步 问题 处 理 得 游 丸 
有 余 。C# 5 采用 async/await 机 制 ， 进 一 步 简 化 了 主流 语言 的 异步 编程 模 
式 。 此 项 特性 共 包 含 2 项 关于 async 方 法 的 补充 内 容 。 


async 方 法 会 生成 一 个 返回 值 ， 该 返回 值 代表 了 一 个 异步 操作 。 这 
部 分 完全 不 需要 开发 人 员 介入 。 该 返回 值 的 类 型 一 般 是 Task 或 

者 Task<T>。 

async 方 法 使 用 await 表 达 式 来 消费 异步 操作 。 如 果 async 方 法 试图 等 
竺 一 个 尚未 完成 的 操作 ， 访 方法 就 会 异步 地 暂停 ， 直 到 操作 完成 后 
再 继续 执行 。 


说 明 其实 称 “异步 函数 ”更 合适 ， 因 为 匿名 方法 和 lambda 表 达 式 也 














可 以 是 异步 的 。 

异步 操作 和 异步 暂停 这 两 个 概念 的 具体 细节 和 机 制 较为 复杂 ， 这 里 不 再 
黎 述 。 总 而 言 之 ， 和 任 借 上 述 特性 ， 我 们 可 以 按照 编写 同步 代码 的 方式 来 
编写 异步 代码 ， 同 时 让 并 发 操作 更 接近 上 自然 的 思维 方式 。 参 考 如 下 示例 
代码 ， 假 设 有 一 个 由 Windows Forms 事 件 触发 的 异步 方法 : 

private async Task UpdateStatus( ) 


Task<weather> weatherTask = GetweatherAsync(); (本 行 及 以 下 1 行 ) 
Task<EmailStatus> emailTask = GetEmaliJStatusAsync( ) ， 





Weather weather = await weatherTask; (本 行 及 以 下 1 行 ) 异步 地 等 待 - 
EmailStatus email = await emailTask; 





weatherLabel.Text = weather.Description; (本 行 及 以 下 1 行 ) 更 新 用 
inboxLabel.Text = email.InboxCount.ToString( ); 


} 


这 段 代码 展示 了 如 何 同时 局 动 两 个 并 发 操作 并 等 竺 返回 结果 ， 还 展示 了 
async/await 如 何 识别 同步 上 下 文 。 这 段 代 码 同 时 做 两 件 事 : 更 新 UI 信息 
(只 能 在 UI 线程 中 执行 )， 局 动 并 等 待 一 个 耗 时 很 长 的 操作 。 

在 async/await 机 制 出 现 以 前 ， 同 样 功能 的 实现 代码 更 复杂 且 容 易 出 错 。 


然而 并 不 是 有 了 async/await 之 后 处 理 异步 编程 就 变 得 轻而易举 了， 异步 
编程 目 身 的 复杂 性 不 会 束 此 消失 ， 它 只 是 剔除 了 以 前 那些 样板 代码 ， 便 
于 开发 人 员 将 精力 集中 于 异步 编程 的 核心 难点 。 


上 述 特性 都 致力 于 精简 代码 ， 关 于 最 后 一 个 特性 ， 下 面 讲 一 些 不 一 样 的 


1.1.5 ”编码 效率 与 执行 效率 之 间 的 取 合 

我 仍 记 得 第 一 次 使 用 Java 时 的 感受 。 那 时 Java 还 是 彻头彻尾 的 解释 性 语 
言 ， 而 且 执 行 速度 极 慢 。 不 久之 后 ，JIT (Just-In-Time) 编译 器 开始 进 
入 人 们 的 视野 ， 并 最 终 发 展 成 为 Java 实 现 的 唯一 指定 编译 方式 。 

之 后 为 了 提升 Java 语 言 的 性 能 ， 大 家 可 谓 辜 精 竭 虑 。 众 人 在 Java 映 上 倾 


注 心血 ， 起 码 证 明 Java 肯 定 个 是 一 于 失败 的 产品 。 开 发 人 员 看 到 了 它 的 
潜力 ， 感 受到 它 为 开 友 效率 带 来 了 前 所 未 有 的 提升 。 程 序 的 运行 速度 同 





























开发 和 交付 的 速度 比 起 来 ， 往 往 就 显得 不 那么 重要 了 。 


相 较 而 言 ， 当 时 C# 的 境况 略 有 不 同 。 从 一 开始 ，CLR (Common 
Language Runtime) 的 表现 就 相当 不 俗 。C# 语 言 既 文 持 同 本 地 代码 的 轻 
松 交 互 ， 也 文 持 由 指针 实现 的 性 能 敏感 的 非 安 全 代码 。C# 的 性 能 一 直 在 
不 断 提 升 。《〈 微 软 正 在 引入 一 套 类 似 于 Java HotSpot JIT 编 译 占 的 分 层 
JIT 编 译 机 制 。) 


然而 ， 工 作 负 载 的 差异 导致 了 性 能 需求 上 的 差异 。1.2 贡 将 介绍 ， 从 游 
戏 到 微服 务 ，C# 的 应 用 平 全 范围 之 广 令 人 惊叹 。 这 些 干 差 万 别 的 平 合 对 
于 程序 性 能 的 需求 都 不 尽 相 同 。 


虽然 异步 特性 解决 了 某 些 场景 中 的 性 能 问题 ， 但 是 C# 7 才 是 提升 程序 性 
能 最 多 的 一 个 版 本 。 只 读 结构 体 和 ref 特 性 都 可 以 用 于 消除 复制 宛 余 。 
最 新 的 span<T> 特 性 (得 到 了 类 ref 结 构 体 类 型 的 支持 ) 有 助 于 减少 不 必 
要 的 内 在 分 配 和 培 级 回收 ， 如 果 开 发 人 员 能 用 好 这 些 特性， 无 能 名 清 
很 多 需求 。 


然而 我 个 人 对 这 些 新 特性 依旧 心 存 疑虑 ， 因 为 它们 毕竟 还 是 有 些 复杂 。 
例如 ， 在 只 使 用 普通 值 参数 就 可 以 的 情况 下 ， 为 何 要 使 用 in 参数 呢 ? 再 
比如 ， 哪 些 场景 适合 使 用 ref 局 部 变量 和 ref return? 这 些 问 题 一 时 三 刻 
我 也 无 法 参 想 透彻 。 


因此 我 认为 ， 使 用 新 特性 一 定 要 如 循 适度 的 原则 。 在 真正 合适 的 场景 
中 ， 代 码 简 化 的 效果 才 会 显著 。 而 且 对 于 代码 维护 人 员 来 说 ， 能 够 维护 
更 简洁 的 代码 ， 也 是 一 件 求 之 不 得 的 事情 。 之 后 我 会 在 个 人 项 目 中 试用 
这 些 新 特性 ， 并 努力 在 性 能 提升 和 代码 复杂 度 之 间 做 好 权衡 。 


对 于 C# 设 计 团队 在 引入 新 特性 时 是 否 充分 考虑 了 这 些 特性 的 使 用 频 度 这 
件 事 ， 我 持 怀疑 态度 。 大 家 不 必 为 了 用 特性 而 去 用 ， 而 要 有 目的 、 有 先 
择 性 地 使 用 。 关 于 最 优选 择 ，C# 7 还 开创 性 地 引入 了 一 个 全 新 的 元 特 
性 ， 使 用 小 版 本 号 。 


1.1.6 ”快速 迭代 : 使 用 小 版 本 号 
C# 的 版 本 号 比较 奇特 ， 很 多 开发 人 员 也 摘 不 清楚 framework 版 本 号 和 话 


言 版 本 号 之 间 的 关系 。〔 比 如 C# 实 际 上 没有 3.5 这 个 版 本 。.NET 
Framework 3.0 版 本 是 跟 C# 2 一 起 推出 的 ， 而 .NET Framework 3.5 是 随 C# 























3 发 布 的 。) C# 1 有 两 个 发 行 版 ; C# 1.0 和 C# 1.2; 而 在 C# 2 到 C# 6 期 
间 ， 都 只 有 大 版 本 号 ， 随 之 发 布 的 还 有 新 版 本 的 Visual Studio。 


C# 7 首次 推出 了 这 样 一 个 特性 : 新 发 布 的 C# 7.0、C# 7.1、C# 7.2 以 及 C# 
7.3 这 几 个 语言 版 本 在 Visual Studio 2017 中 都 可 以 使 用 。 后 续 的 C# 8 大 概 
率 还 将 沿用 该 模式 。 这 一 特性 旨 在 根据 使 用 者 的 反馈 对 C# 进 行 快速 迭 

， C# 7.1~C# 7.3 这 几 个 版 本 的 大 部 分 特性 是 基于 7.0 版 本 的 变 体 或 者 扩 - 


这 种 语言 特性 的 不 稳定 ， 会 给 使 用 者 尤其 是 大 型 公司 造成 困惑 。 许 多 公 
司 对 基础 架构 所 做 的 变动 或 升级 ， 都 是 为 了 确保 能 够 完全 文 持 新 版 本 。 
另外 ， 很 多 开发 人 员 学 习 和 接纳 这 些 新 特性 的 步调 可 能 也 会 不 一 致 。 束 
算 抛 开 这 些 问题 不 谈 ， 对 于 一 门 更 新 速度 比 你 适应 速度 还 要 快 的 语言 ， 
谁 都 会 多 少 有 些 不 悦 吧 。 


基于 上 述 考 虑 ，C# 编 译 占 上 默认 使 用 最 新 主 版 本 写 的 最 早 小 版 本 写 。 对 于 
C# 7 编译 器 来 说 ， 如 果 不 指定 语言 版 本 ， 那 么 它 默 认 会 使 用 C# 7.0 版 
本 。 如 采 需 要 使 用 后 续 的 小 版 本 号 ， 需 要 在 工程 文件 中 显 式 声 明 ， 才 能 
够 使 用 新 特性 。 


指定 小 版 本 号 有 两 种 方法 ， 二 者 作用 相同 。 一 是 直接 在 工程 文件 的 
<PropertyGroup> 标 签 中 添加 <Langversion>， 如 下 所 示 。 

















< 其 他 属性 
<LangVersion>latest</LangVersion> <------ 间 定 工程 的 语言 版 本 
</PropertyGroup> 


不 想 直 接 编辑 工程 文件 的 话 ， 也 可 以 在 Visual Studio 中 选择 项 目 属性 ， 
在 构建 (Build) 标签 中 点 选 右 下 方 的 高 级 (Advanced) 按钮 。 在 弹出 
的 对 话 框 中 ， 就 可 以 选择 想 使 用 的 语言 版 本 了 ， 另 外 还 有 一 些 选 项 可 供 
设置 ， 见 图 1-1。 











图 1-1 Visual Studio 中 的 语言 版 本 设置 


随 着 该 特性 的 推出 ， 你 将 更 频繁 地 用 到 上 面 这 个 对 话 框 。 版 本 号 提供 的 
可 选项 如 下 所 示 。 


。 默认 : 当前 大 版 本 号 下 的 第 一 个 小 版 本 号 。 
。 最 新 : 当前 最 新 的 版 本 号 。 
。 自 定义 版 本 号 ; 比如 可 以 填 “7.0” 或 者 “7.3”。 


上 述 操作 不 会 对 当前 编译 器 的 版 本 号 产生 影响 ， 它 只 是 用 于 调整 当前 语 
言 可 用 特性 的 集合 。 如 果 目 标 版 本 不 文 持 代码 中 使 用 的 新 特性 ， 编 译 右 
就 会 发 出 错误 信息 ， 提 示 应 当 指 定 正确 的 版 本 写 。 如 果 使 用 的 新 特性 是 











编译 器 根本 无 法 识别 的 ， 例 如 在 C# 6 编译 器 中 使 用 C# 7 的 特性 ， 那 么 错 
误 信 息 就 无 法 做 出 精准 的 提示 了 。 


C# 语 言 从 诞生 之 初 经 历 了 漫长 的 演化 历程 ， 那 么 C# 所 运行 的 平台 义 有 
怎样 一 段 历史 呢 ? 


1.2 一 个 与 时 俱 进 的 平台 


过 去 几 年 令 广 大 .NET 程 序 员 振奋 人 不已， 期间 虽然 也 经 历 了 不 少 坎 坷 ， 但 
微软 和 .NET 社 区 还 是 针对 更 开放 化 的 开发 模型 达成 了 共识 。 众 人 和 凭借 着 
艰 注 付出 ， 取 得 了 令 人 了 瞩目 的 成 束 。 


此 前 的 很 多 年 ， 要 在 Windows 上 运行 C# 程 序 基 本 是 一 个 心照 不 宣 的 事 
实 。 要 么 用 Windows Forms 或 WPF 编 写 客 户 端 程序 ， 要 么 用 ASP.NET 编 
写 在 IIS 上 运行 的 服务 端 程序 。 虽 然 不 是 不 能 选择 其 他 平台 ， 尤 其 还 有 
着 像 Mono 这 样 由 来 已 久 的 跨 平台 项 目 ， 但 是 .NET 开 发 实际 上 还 是 以 在 
Windows 上 为 主 。 


这 段 文字 写 于 2018 年 6 月 ， 此 时 的 .NET 早 已 今 非 昔 比 。 其 中 最 为 瞩目 的 
当 属 .NET Core， 它 既是 运行 时 ， 也 是 框架 ， 还 具备 开源 和 可 移植 的 特 
性 ， 能 够 在 不 同 操作 系统 上 运行 ， 由 微软 全 面 背书 ， 同 时 配备 有 完备 的 
开发 工具 流 。 这 些 特性 于 几 年 前 几乎 是 不 可 想象 的 。 再 加 上 Visual 
Studio Code 这 样 一 款 开 源 且 可 移植 的 IDE， 就 打造 出 了 一 个 繁荣 的 .NET 
生态 系统 。 今 后 ， 开 发 人 员 终 于 可 以 在 不 同 平 台 上 完成 .NET 开 发 工作 ， 
并 能 把 程序 部 署 到 各 种 服务 器 上 了 。 


当然 ， 除 了 .NET Core， 运 行 C# 的 方式 还 有 很 多 ， 其 中 Xamarin 就 提供 了 
丰富 的 路 移动 平台 体验 ， 其 GUI 框架 (Xamarin Forms) 可 以 让 开发 人 员 
构建 出 跨 平台 的 统一 UI， 还 可 以 充分 利用 运行 设备 的 平台 特性 。 


Unity 是 世界 上 最 受 欢 迎 的 游戏 开发 平台 之 一 。Unity 拥 有 一 套 定制 化 的 
Mono 运 行 时 和 预 编译 机 制 ， 这 对 于 那些 习惯 了 传统 运行 时 环境 的 C# 开 
发 人 员 来 说 ， 将 是 一 个 挑战 。 不 过 依然 有 很 多 开发 人 员 是 通过 Unity 第 
一 次 接触 C# 这 门 开 发 语言 的 。 


这 些 应 用 平台 数量 之 多 ， 已 经 远 超 C# 的 创作 平台 ， 例 如 近期 我 一 直 在 用 
Try .NET 和 Blazor， 它 们 提供 的 浏览 絮 与 C# 直 接 交 互 的 体验 非 第 与 众 不 




















同 。 


使 用 Try .NET 它 还 具有 代码 目 动 补 齐 的 特性 ) ， 开 发 人 员 可 以 在 浏览 
器 中 直接 编写 C# 代 码 ， 之 后 还 可 以 在 浏览 右 中 完成 构建 和 运行 。 对 于 
C# 切 学 者 而 言 ， 这 会 是 一 种 绝 佳 的 轻松 入 门 体验 。 


Blazor 是 一 个 允许 直接 在 浏览 器 中 运行 Razor 页 面 的 平台 。 这 种 模式 不 同 
于 那些 在 服务 器 端 演 染 然后 交 由 浏览 器 展示 的 方式 ， 它 把 UI 相关 代码 都 
放 到 浏览 器 中 去 执行 ， 使 用 Mono 运 行 时 将 代码 转换 为 WebAssembly。 
这 种 由 浏览 器 中 的 JavaScript 引 苟 来 执行 工 代 码 的 整个 运行 时 机 制 ， 同 时 
支持 计算 机 和 手机 终端 ， 这 在 几 年 前 是 不 敢 想 象 的 。 


C# 平 台 这 些 年 的 变革 ， 同 样 离 不 开 一 个 空前 合作 和 开放 的 社区 。 
1.3 一 个 与 时 俱 进 的 社区 


从 C# 1.0 起 我 便 加 入 了 社区 ， 还 从 未 见 过 它 散 发 着 今日 这 般 活 力 。 在 我 
刚 开 始 使 用 C# 时 ， 它 更 多 被 视 作 一 种 “企业 级 ”编程 语言 ， 既 无 聊 ， 可 探 
索 度 也 不 够 高 。1 在 这 种 情况 下 ， 与 其 他 语言 相 比 ，C# 的 开源 生态 系统 
自然 成 长 得 十 分 缓慢 。 就 算 对 比 同 样 被 视 作 企业 级 编程 语言 的 Java，C# 
也 是 自 愧 弗 如 。 而 到 了 C# 3 之 后 ，altNET 社 区 就 已 经 超越 了 主流 .NET 
的 发 展 速度 ， 颇 有 几 分 和 微软 分 庭 抗 礼 的 意味 。 


1 别 误会 我 的 意思 。 这 是 一 个 令 人 愉快 的 社区 ， 一 直 有 人 为 了 乐趣 而 学 
试 使 用 C#。 


于 2010 年 问世 的 NuGet 包 管理 器 《最 初 名 字 是 NuPack) 简化 了 类 库 的 编 
写 和 使 用 ， 无 论 是 商业 库 还 是 开源 库 都 因此 获 益 。 下 载 一 个 zip 文 件 或 

者 正确 复制 并 引用 一 个 DLL 文件 都 很 简便 ， 但 是 无 论 哪个 进行 得 不 顺 

利 ， 都 有 可 能 令 开 发 人 员 和 月 难 而 退 。 


说 明 “一些 包 管理 器 更 早 问世 ， 其 中 Sebastien Lambla 开 发 的 
OpenWrap 项 目 鼎 有 影响 。 


2014 年 微软 宣布 计划 将 其 Roslyn 编 译 器 平台 开源 ， 并 同步 推出 新 版 
的 .NET Foundation 为 其 护航 。 紧 接着 .NET Core〈 最 初 隶属 于 一 个 代号 
为 “Project K” 的 项 目 ) 也 宣布 即将 发 布 DNX， 之 后 .NET Core 工 具 最 终 














发 布 并 且 逐 渐 成 熟 。 其 后 微软 连续 发 布 了 ASP.NET Core、Entity 
Framework Core 以 及 Visual Studio Code。 这 些 项 目 都 扎根 并 长 期 活跃 于 
GitHub 上 ,日 渐 壮 大 。 


创建 健康 社区 ， 技 术 在 其 中 的 重要 作用 毋庸 置疑 ， 而 微软 拥抱 开源 这 一 
举措 ， 同 样 至 关 重 要 。 各 种 第 三 方 开源 包 途 动 友 展 ， 包 括 对 Roslyn 的 创 
ed 以 及 集成 .NET Core 工 具 这 些 举 措 ， 都 预示 着 一 个 更 加 美好 的 














社区 能 有 今天 的 繁荣 并 不 是 无 缘 无 故 的 。 云 计算 的 崛起 使 得 .NET Core 
在 .NET 生 态 系统 中 变 得 空前 重要 ， 对 Linux 系 统 的 支持 成 为 了 必然 要 
求 。 有 了 .NET Core 之 后 ， 像 在 Docker 镜 像 中 打包 一 个 ASP.NET Core 服 
务 ， 使 用 Kubernetes 进 行 部 署 ， 使 之 成 为 多 种 语言 混合 的 大 型 应 用 的 一 
部 分 ， 这 一 切 都 变 得 顺理成章 。 各 个 社区 之 间 不 断交 流 和 局 迪 优 秀 想法 
已 兰 然 成 风 。 


学 习 C#， 一 球 浏览 器 就 能 满足 要 求 ， 运 行 C#， 没 有 平台 限制 ， 探 讨 
C#，Stack Overflow 以 及 其 他 众多 站 点 任 君 选择 。 加 入 C# 团 队 在 GitHub 
上 的 讨论 组 ， 共 商 C# 的 未 来 大 计 也 不 再 是 梦想 。 尽 管 C# 还 不 够 完美 ， 
打造 一 个 深 得 人 心 的 C# 社 区 也 依然 有 很 长 的 路 要 走 ， 但 目前 来 看 已 经 取 
得 了 相当 不 错 的 成 绩 。 


Ue 
g 呢 ? 


1.4 一 本 与 时 俱 进 的 好 书 


迄今 为 止 ， 本 书 已 推出 第 4 版 。 尽 管 它 更 新 的 速度 相 较 语 言 、 平 台 以 及 
社区 而 言 稍 慢 ， 但 是 相 比 第 1 版 也 早已 不 可 同日 而 语 。 下 面 简 要 介绍 这 
一 版 最 为 美妙 的 几 个 地 方 。 


1.4.1 内 容 详 略 得 当 


本 书 《〈 英 文 版 ) 第 1 版 于 2008 年 4 月 面世 ， 恰 着 我 入 职 谷 歌 。 那 时 我 注意 
到 ， 好 多 已 经 精通 C# 1 的 开发 人 员 正 在 努力 学 习 C# 2 或 者 C# 3， 但 是 他 
们 对 于 许多 知识 碎片 无 法 很 好 地 融会 贯通 ， 于 是 我 决定 破除 这 一 阻碍 ， 
开始 深入 研究 C# 语 言 本 身 ， 和 希望 可 以 让 读者 对 C# 的 各 项 特性 知 其 然 也 
































知 其 所 以 然 。 


此 外 ， 开 发 人 员 的 需求 也 会 随 着 时 间 的 推移 而 发 生变 化 。 受 C# 社 区 潜 移 
默 化 的 影响 ， 很 多 开发 人 员 对 C#i 语 言 的 早期 版 本 已 经 有 了 兢 为 深入 的 认 
识 〈 尽 管 不 是 人 人 如 此 ) 。 逐 个 版 本 地 学 习 C# 语 言 的 演化 历程 是 很 有 神 
区 的 一 件 事 ， 可 是 既然 本 书 已 经 出 到 第 4 版 ， 我 还 是 想 把 重点 放 在 C# 的 
几 个 新 版 本 上 。 对 于 C# 2 到 C# 4 之 间 的 很 多 细节 ， 本 书 暂 不 做 探讨 。 


说 明 ”逐个 版 本 地 学 习 一 门 语言 不 是 从 零 开 始 学 习 的 最 佳 方法 ， 但 
有 助 于 深入 理解 。 对 于 C# 初 学 者 ， 我 不 会 这 样 组 织 内 容 。 
当 读 者 看 到 一 本 厚 厚 的 大 部 涉 ， 往 往 会 心 生 戎 慨 ， 止 步 不 前 。 一 本 太 过 
厚重 的 书 ， 写 起 来 会 很 辛苦 ， 坚 持 读 下 去 的 读者 也 会 很 辛苦 。 如 果 用 
400 页 的 篇 幅 来 讲述 C# 2 到 C# 4 的 版 本 ， 估 计 后 面 怎 么 写 都 不 太 对 劲 
Ts 

















基于 以 上 这 些 原因 ， 我 对 C# 早 期 的 几 个 版 本 的 内 容 进行 了 压缩 。 本 书 还 
会 涉及 早期 版 本 的 特性 ， 但 只 会 在 必要 时 做 深入 探讨 。 即 便 是 深入 探讨 
的 部 分 ， 也 会 比 第 3 版 简略 一 些 。 读 者 可 以 把 第 4 版 简 述 的 内 容 当 作对 已 
有 知识 的 回顾 ， 在 需要 深究 之 处 则 可 以 参考 第 3 版 〈 第 3 版 没有 讨论 C# 6 
和 C# 7) 。 对 于 C# 5 到 C#7 这 几 个 版 本 ， 本 书 会 详细 阐述 ， 其 中 异步 问 
题 依然 会 是 重头 戏 。 
写 书 这 件 事 就 像 软 件 工 程 一 样 ， 通 常 都 是 一 个 不 断 权衡 利 闵 的 过 程 。 至 
于 本 书 所 做 的 详 略 权衡 能 否 满足 读者 的 需求 ， 就 只 能 交 由 时 间 去 检验 
了 。 假 如 还 能 有 第 5 版 ， 我 希望 自己 可 以 做 得 更 好 。 
提示 “如 果 你 阅读 的 是 本 书 纸 质 版 ， 强 烈 建议 在 书 上 做 批注 : 哪些 
地 方 你 不 认同 ， 哪 些 地 方 你 觉得 很 有 用 。 做 笔记 有 助 于 强化 记忆 ， 
之 后 也 可 作为 提示 。 


1.4.2 ”使 用 Noda Time 作 为 示例 

本 书 给 出 的 示例 代码 大 多 是 互 无 关联 的 。 如 果 可 以 癌 读 者 展示 如 何 将 这 
些 示例 应 用 于 产品 级 代码 ， 可 能 会 更 具 说 服 力 ， 为 此 我 选择 了 Noda 
Time 作 为 产品 级 工程 。 

Noda Time 是 我 于 2009 年 创建 的 一 个 开源 项 目 ， 旨 在 为 .NET 提 供 更 优秀 














的 日 期 和 时 间 库 。 不 过 创建 该 项 目 还 有 另外 一 个 目的 ， 束 是 把 它 作为 一 
个 很 棒 的 沙 盒 项 目 。 通 过 这 个 项 目 ， 我 既 可 以 提升 API 设 计 能 力 ， 又 可 
以 学 习性 能 和 基准 分 析 的 相关 内 容 ， 还 可 以 试验 C# 的 新 特性 。 当 然 ， 这 
些 都 是 在 不 影响 用 户 使 用 体验 的 前 提 下 进行 的 。 


C# 每 个 版 本 引入 的 新 特性 ， 我 都 会 在 Noda Time 里 使 用 。 我 用 这 些 在 产 
品 中 具体 应 用 的 新 特性 构造 出 了 书 中 的 具体 示例 。 该 项 目的 所 有 代码 均 
可 从 GitHub 上 获取 ， 读 者 可 以 把 它 复制 到 本 地 ， 然 后 上 自己 动手 试验 。 还 
需要 证 请 一 点 ， 用 Noda Time 作 为 示例 不 是 为 了 借 机 推广 我 的 开源 库 。 

当然 ， 如 果 有 读者 愿意 去 熟悉 和 使 用 它 ， 我 也 会 蜡 目 欣喜 的 。 


本 书后 文 提 到 Noda Time 时 ， 都 将 默认 读者 已 经 了 解 其 所 指 代 的 内 容 。 
为 了 使 Noda Time 更 适用 于 示例 ， 需 要 做 到 以 下 几 个 关键 点 。 


。 代 码 可 读 性 要 尽量 强 。 我 会 不 遗 余力 地 应 用 那些 有 助 于 增强 可 读 性 
的 新 特性 来 不 断 重 构 代码 。 

。Noda Time 遵 循 语义 化 版 本 规则 ， 极 少 更 新 主 版 本 号 。 在 应 用 新 特 
性 时 ， 我 会 注重 向 后 兼容 的 问题 。 

。 在 不 增加 代码 复杂 性 的 前 提 下 ， 我 会 尽 可 能 应 用 那些 能 够 提升 性 能 
的 特性 。 不 过 ， 由 于 Noda Time 使 用 场景 的 不 确定 性 ， 无 法 设置 具 
体 的 性 能 指标 。 


1.4.3 ”术语 选择 


本 书 尽 可 能 采用 C# 官 方术 语 ， 但 有 时 为 了 追求 表述 上 的 清晰 而 不 得 已 使 
用 了 一 些 非 精准 的 术语 ， 例 如 在 说 到 异步 时 ， 我 总 是 用 async 方 法 来 代 
指 ， 该 术语 也 可 以 用 于 代 指 卉 步 匿 名 函数 。 又 如 对 象 初始 化 器 这 个 概 

念 ， 它 既 适 用 于 可 访问 字段 ， 也 适用 于 属性 。 简 便 起 匈 ， 只 在 这 里 解释 


一 次 ， 之 后 书 中 都 将 其 用 于 属性 。 


还 有 一 些 在 C# 语 言 规范 中 使 用 的 术语 ， 在 广大 社区 中 使 用 频 度 很 低 ， 例 
如 规范 中 有 一 个 函数 成 员 的 概念 。 它 可 以 是 一 个 方法 、 属 性 、 事 件 、 索 
引 右 、 目 定义 操作 、 实 例 构 造 右 、 静 态 构造 锅 或 终结 右 。 该 术语 指 的 
是 “任何 包含 可 执行 代码 的 类 型 成 员 ”， 可 有 效用 于 描述 语言 特性 。 不 过 
该 术语 在 实际 编码 中 很 少 会 用 到 ， 所 以 即便 从 没 听 过 也 不 足 为 奇 。 书 中 
尽 可 能 地 避免 使 用 这 类 术语 ， 但 读者 还 是 有 必要 了 解 它 们 ， 以 便 深 化 对 
语言 本 里 的 认识 。 


























最 后 ， 还 有 一 些 概念 没有 对 应 的 官方 术语 。 对 于 这 类 概念 ， 我 会 用 一 些 
特定 的 短语 来 指 代 。 其 中 用 得 最 多 的 一 个 应 该 就 是 难 言 之 名 
(unspeakable name) 了 。 该 术语 由 Eric Lippert 提 出 ， 用 于 指 代 由 编译 
器 生成 的 标识 符 。 该 标识 符 用 于 实现 欠 代 器 块 或 lambda 表 达 式 等 特性 ， 
在 CLR 中 它 是 有 效 的 标识 符 ， 而 在 C# 中 它 是 无 效 的 标识 符 。 这 是 一 个 真 
实 存 在 的 名 字 ， 但 是 又 无 法 用 C# 的 语言 表述 ， 因 此 称 其 为 “ 难 言 之 名 ”。 
也 正 是 因为 如 此 ， 该 标识 符 不 会 与 实际 代码 产生 冲突 。 











1.5 ”小结 


我 热爱 C# 这 门 美妙 又 动人 心 昕 的 语言 ， 也 期 符 痢 它 能 有 更 加 美好 的 未 
来 。 布 望 这 种 体验 可 以 传递 给 正在 阅读 的 你 。 让 我 们 一 起 马不停蹄 地 开 
始 探索 后 面 真 正 的 精彩 吧 。 


第 二 部 分 “从 C# 2 到 C#5 


这 部 分 介绍 从 C# 2 〈 随 Visual Studio 2005 发 布 ) 到 C#5( 随 Visual Studio 
2012 发 布 ) 引入 的 全 部 特性 ， 这 正 是 本 书 第 3 版 的 全 部 内 容 。 其 中 相当 
二 部 分 内容 现在 看 来 己 经 过 时 了 ， 比 如 泛 型 这 种 大 家 早已 习以为常 的 概 
从 C# 2 到 C# 5， 是 C#i 否 言 极 其 繁盛 的 一 段 时 期 。 这 部 分 会 介绍 以 下 特 
性 : 泛 型 、 可 空 值 类 型 、 匿 名 方法 、 方 法 组 转换 、 和 迭代 器 、 局 部 类 型 、 
静态 类 、 自 动 实 现 的 属性 、 隐 式 类 型 局 部 变量 、 隐 式 类 型 数组 、 对 象 初 
始 化 器 、 集 合 初始 化 器 、 匿 名 类 型 、lambda 表 达 式 、 扩 展 方法 、 查 询 表 
达 式 、 动 态 类 型 、 可 选 参数 、 命 名 参数 、COM 改 进 、 泛 型 协 变 与 抗 
变 、async/await， 以 及 调用 方 信息 attribute 等 。 


我 假定 读者 对 这 部 分 所 涉 大 部 分 特性 有 一 定 了 解 ， 因 此 讲解 市 稚 会 比较 
快 。 为 尽量 缩短 篇 幅 ， 这 部 分 讲解 不 会 像 第 3 版 那么 细致 。 布 望 这 部 分 
内 容 能 满足 读者 的 以 下 需求 : 


。 重 温 C# 的 特性 ， 查 漏 补缺 ; 
。 理解 特性 的 原理 、 来 龙 去 脉 和 设计 思路 ; 
。 快速 查找 相关 特性 的 语法 。 


温馨 提 示 : 阁 想 深入 了 解 更 多 细节 ， 可 参考 第 3 版 的 相关 内 容 。 


async/await 是 一 个 例外 。 它 是 C#5 中 最 庞大 的 特性 ， 这 一 版 重 写 了 相关 
内 容 。 第 5 章 闻 着 了 async/await 的 全 部 内 容 ， 第 6 章 则 重点 讲解 该 特性 的 
实现 原理 。 对 于 刚 接触 async/await 的 读者 ， 建 议 在 阅读 第 6 章 前 ， 先 对 
该 特性 进行 一 番 实 践 。 即 便 经 过 实践 ， 第 6 章 的 内 容 也 不 易 理 解 。 尽 管 
我 已 经 竭尽 所 能 地 以 最 浅显 易 慌 的 方式 来 讲述 ， 但 是 该 特性 本 号 非常 复 
杂 。 和 希望 读者 尽力 理解 第 6 章 的 内 容 ， 因 为 若 能 深入 理解 async/await 的 
机 制 ， 即 便 不 深入 研究 编译 器 生成 的 下 代码 ， 也 能 在 使 用 这 项 特性 时 更 
胸 有 成 人 竹 。“ 哺 ” 完 第 6 章 后 就 能 松 一 口气 了 ， 第 7 章 的 内 容 简 单 许多 ， 它 
丰 全 书 最 简短 的 一 章 ， 读者 正好 可 以 在 打 完 第 6 章 的 攻坚 战 之 后 稍 事 休 

















介绍 环节 到 此 为 止 ， 下 面 请 准备 接受 C# 特 性 的 “洗礼 * 吧 。 


入 和 7 
有 书 2 齐 C#2 
本 章 内 容 概览 


。 如 何 使 用 泛 型 类 型 和 泛 型 方法 编写 灵活 、 安 全 的 代码 ; 
。 如 何 通过 可 空 值 类 型 表示 信息 缺失 ; 

。 如 何 简 化 创建 委托 的 方式 ; 

。 如 何在 不 使 用 样板 代码 的 前 提 下 实现 欠 代 融 。 


对 于 经 验 丰富 的 C# 开 及 人 员 来 说 ， 本 章 更 像 是 一 部 回忆 录 ， 大 家 共同 追 
忆 C# 这 些 年 走 过 的 漫长 历程 ， 共 同感 谢 它 背后 的 那个 割 希 、 专 注 的 语言 
设计 团队 。C# 初 学 者 则 会 更 惊讶 于 当年 没有 这 些 特性 的 C# 是 如 何 迅速 
是 起 的 1。 无 论 是 哪 类 读者 ， 阅 读本 章 都 会 受 普 匪 浅 ， 因 为 总 会 友 现 一 
些 之 前 从 未 注意 到 或 从 未 深 完 过 的 特性 。 


1 在 我 看 来 ， 原 因 很 简单 : 对 于 当时 的 很 多 开发 人 员 来 说 ， 即 便 是 C# 1 
也 比 Java 更 高 效 。 


C# 2《〈 以 及 Visual Studio 2005) 目 问世 至 今 已 10 年 有 余 。 以 今天 的 眼光 
来 审视 C# 2 的 特性 时 ， 内 心 应 当 已 经 十 分 平静 了 ， 但 是 当年 C# 2 发 布 意 
义 之 重大 依旧 不 能 小 裔 。 那 段 历程 也 是 相当 煎熬 的 ， 从 C# 1 和 .NET 1.x 
升级 到 C# 2 和 .NET 2.0， 花 了 好 长 时 间 才 得 到 业界 的 认可 和 推广 。 之 
后 ，C# 各 版 本 的 演进 速度 不 断 加 快 。 下 面 将 介绍 泛 型 ， 几 乎 所 有 开发 人 
员 都 认为 它 是 C# 2 引入 的 最 重要 的 特性 。 




















2.1 泛 型 








使 用 泛 型 〈generic) ， 可 以 编写 在 编译 时 类 型 安全 的 通用 代码 ， 无 须 事 
先知 道 要 使 用 的 具体 类 型 ， 即 可 在 不 同位 置 表示 相同 类 型 。 在 引入 之 
初 ， 泛 型 主要 用 于 集合 。 如 今 ， 泛 型 已 经 广泛 应 用 于 C# 的 各 个 领域 ， 其 
中 用 得 较 多 的 有 如 下 几 项 : 

。 集合 〈 在 集合 中 泛 型 一 如 既往 地 重要 ) ; 


。 委托 〈 尤 其 是 在 LINQ 中 的 应 用 ) ; 
。 异步 代码 (Task<T> 表 示 该 方法 将 返回 一 个 类 型 为 ?的 值 〉; 








。 可 空 值 类 型 ( 详 见 2.2 节 )。 


当然 ， 泛 型 的 应 用 场景 远 不 止 上 述 几 项 。 不 过 ， 这 4 项 用 途 足 以 表明 泛 
型 特性 已 经 深入 C# 开 发 人 员 的 日 常 工作 中 了 。 以 集合 为 例 来 展现 泛 型 的 
诸多 优势 ， 可 谓 再 合适 不 过 了 。 可 以 通过 对 比 .NET 1 中 的 普通 集合 

和 .NET 2 中 的 泛 型 集合 来 充分 体会 。 


2.1.1 示例 : 泛 型 诞生 前 的 集合 
.NET 1 有 如 下 3 大 类 集合 。 


， 数组 语言 和 运行 时 直 楼 支 持 数组 。 数 组 的 大 小 在 初 给 化 时 就 已经 
确定 。 

普通 对 象 集合 : API 中 的 值 〈 或 者 键 ) 由 System.0bject 描 述 。 尽 管 
诸如 索引 器 和 foreach 语 句 这 些 语 言 特 性 可 应 用 于 普通 对 象 集合 ， 
但 语言 和 运行 时 并 未 对 其 提供 专门 的 支持 。ArrayList 和 Hashtable 
是 更 常见 的 两 种 对 象 集合 。 

专用 类 型 集合 ，API 中 描述 的 信 具 有 特定 类 型 ， 集 合 只 能 用 于 该 类 
型 。 例 如 stringcollection 是 保存 字符 串 的 集合 ， 虽 然 其 API 看 起 
来 与 ArrayList 的 类 似 ,但 是 它 只 能 接收 string 类 型 的 元 系 ， 而 不 能 
接收 object 类 型 的 。 


数组 和 专用 类 型 集合 部 属于 静态 类 型 ， 因 此 API 可 以 阻止 将 错误 类 型 的 
值 添加 到 集合 中 。 在 从 集合 中 取 值 时 ， 也 无 须 手动 转 换 类 型 。 


说 明 由 于 存在 数组 协 变 机 制 ， 因 此 引用 类 型 的 数组 不 能 完全 确保 
类 型 安全 。 我 认为 ， 数 组 协 变 机 制 是 C# 早 期 的 一 处 设计 失误 。 有 关 
数组 协 变 的 内 容 超出 了 本 书 范 畴 ， 暂 不 讨论 。 各 有 兴趣 ， 请 参考 
Eric Lippert 的 文章 “Covariance and Contravariance in C#, Part Two: 


Array Covariance”， 这 是 他 关于 协 变 与 逆 变 的 系列 文章 之 一 。 


下 面具 体 看 看 。 假设 有 一 个 名 为 GenerateNames 的 方法 ， 该 方法 用 于 创 
建 一 个 String 类 型 的 集合 ， 此 外 还 有 一 个 名 为 PrintNames 的 方法 ， 它 可 
以 把 该 集合 的 所 有 元 素 显 示 出 来 。 我 们 分 别 用 上 述 三 种 集合 〈 数 

组 、ArrayList 以 及 stringcollection) 来 实现 ， 然 后 对 比 这 三 者 的 优 

劣 。 采 用 这 三 种 方式 创建 集合 ， 代 码 大 同 小 异 〈 尤 其 是 PrintNames 方 

法 ) ， 请 容 我 慢 慢 道 来 。 首 先是 数组 。 


























代码 清单 2-1 使 用 数组 创建 并 打印 names 


static string[] GenerateNames() 








string[] names = new string[4]; <------ 在 创建 数组 时 就 必须 获得 数 年 
names[0] = "Gamma"; 
names[1] = "Vlissides"; 
names[2] = "Johnson"; 
names[3] = "Helm"; 
return names; 
} 
static void PrintNames(string[] names ) 
{ 
foreach (string name in names) 
Console.writeLine(name); 
} 


代码 清单 2-1 中 特意 没有 使 用 数组 初始 化 器 来 创建 数组 ， 而 是 模拟 了 逐 
个 获取 names 元 系 的 场景 ， 比 如 读 文 件 。 为 外 需 注意 ， 在 创建 数组 时 就 
应 当 为 其 确定 合适 的 大 小 。 像 读 文件 这 种 情况 ， 就 需要 事先 知道 文件 中 
有 多 少 个 名 字 ， 才 能 在 创建 数组 时 为 其 分 配 大 小 。 或 者 采用 更 复杂 的 方 
式 ， 比 如 先 创 建 一 个 初始 数组 ， 如 果 初 始 数 组 被 填 满 ， 就 再 创建 一 个 更 
大 的 数组 ， 把 初始 数组 中 的 元 系 全 部 复制 到 新 数组 中 ， 如 此 循环 往复 ， 
直到 所 有 元 素 添 加 完毕 。 之 后 ， 如 果 数 组 依然 有 剩余 空间 ， 可 能 需要 再 
创建 一 个 大 小 合适 的 数组 ， 再 把 所 有 元 系 复 制 到 最 终 的 这 个 数组 中 。 


诸如 追踪 当前 集合 大 小 、 重 新 分 配 数组 等 重复 性 操作 ， 都 可 以 用 一 个 类 
型 封装 起 来 ， 使 用 ArrayList 即 可 实现 。 


代码 清单 2-2 ”使 用 ArrayList 创 建 并 打印 names 


static ArrayList GenerateNames( ) 











ArrayList names = new ArrayList(); 
names.Add("Gamma'" ) ; 
names.Add("Vlissides"); 

names .Add("Johnson"); 

names.Add( "Helm"); 

return names; 


static void PrintNames(ArrayList names ) 


{ 


foreach (string name in names) <------ 如 果 ArrayList 中 包含 一 个 非 
Console.WwriteLine(name); 


} 


在 创建 ArrayList 时 ， 无 顷 事先 知晓 names 的 元 素 个 数 ， 

此 GenerateNames 方 法 得 以 进一步 简化 。 不 过 ， 还 有 一 个 和 数组 相同 的 
问题 : 使 用 ArrayList 依 旧 无 法 确保 非 string 类 型 的 值 不 被 添加 进来 ， 
为 ArrayList .Add 方 法 的 参数 类 型 是 object。 


此 外 ，PrintNames 方 法 看 起 来 是 类 型 安全 的 ， 事 实 却 并 非 如 此 ， 因 为 上 
述 集合 可 能 包含 某 些 对 象 引用 。 举 一 个 极端 的 例子 : 该 ArrayList 中 有 
一 个 webRequest 类 型 的 值 ， 这 会 引发 什么 后 果 呢 ? 由 于 name 变 量 声明 
为 string 类 型 ， 因 此 foreach 循 环 每 次 都 会 对 集合 中 的 元 素 执行 隐 式 类 
型 转换 ， 把 object 转 换 为 string。 最 终 ， 从 WebRequest 到 string 的 转换 
会 失败 ， 并 且 抛 出 InvalidcastException。 结果 束 是 ， 虽然 用 ArrayList 
解雇 了 一 个 问题 ， 但 又 引出 了 另外 一 个 问题 。 有 没有 什么 方法 可 以 做 到 
二 者 莱 顾 呢 ? 


代码 清单 2-3 ”使 用 StringcoLlection 创 建 并 打印 names 


static StringCollection GenerateNames() 


{ 











StringCollection names = new StringCollection(); 
names.Add("Gamma" ) ， 

names.Add("V]Lissides") ，; 

names .Add("Johnson"); 

names.Add( "Helm"); 

return names; 


} 
static void PrintNames(StringCollection names) 
foreach (string name in names) 


Console.WriteLine(name); 


} 
除了 把 ArrayList 都 蔡 换 成 了 stringcollection， 代 码 清单 2-3 与 代码 清 








单 2-2 几 乎 完全 一 致 。 这 也 正 是 stringcollection 的 意义 所 在 : 用 法 上 与 
通用 型 集合 并 无 二 致 ， 但 只 负责 处 理 string 类 型 的 元 

素 。 Stringcollection.Add 方 法 的 参数 类 型 是 String， 因此 不 能 向 其 添 
加 webRequest 类 型 的 值 。 这 样 就 保证 了 在 显示 names 时 ，foreach 循 环 不 
会 遇 到 非 string 类 型 的 值 Cnul1 引 用 例外 ) 。 


在 只 需要 处 理 string 类 型 的 情况 下 ，stringcollection 确 实 是 不 二 之 
选 。 可 是 如 果 需 要 使 用 其 他 类 型 的 集合 ， 要 么 寄 希 望 于 .NET Framework 
己 经 提供 了 所 需 的 集合 类 型 ， 要 么 就 只 能 自己 写 一 个 了 。 由 于 类 似 的 需 
求 十 分 普遍 ， 因此 就 有 了 system.collections.CcollectionBase 这 个 抽象 
类 ， 用 于 减少 上 述 重复 性 工作 。 另 外 ， 还 可 以 使 用 一 些 现成 的 代码 生成 
器 ， 来 有 效 规避 纯 手 写 代 人 码 。 


使 用 专用 类 型 集合 可 以 解决 前 面 提 到 的 两 个 问题 ， 但 是 创建 如 此 多 额外 
类 型 ， 代 价 实 在 太 高 了 ， 而 且 当 代码 生成 喜 发 生变 化 时 ， 同 步 更 新 这 些 
类 型 的 维护 成 本 也 不 容 忽 视 。 另 外 ， 编 译 时 间 、 程 序 集 大 小 、JIT 耗 
时 、 代 码 段 内 存 都 会 产生 额外 的 性 能 消耗 ， 最 关键 的 还 有 维护 这 些 集合 
所 需 的 人 力 成 本 。 


即便 上 述 成 本 都 可 以 忽略 ， 也 不 能 忽视 代码 灵活 性 的 降低 : 无 法 以 静态 
方式 编写 适用 于 所 有 集合 类 型 的 通用 方法 ， 也 无 法 把 集合 元 素 的 类 型 用 
于 参数 或 者 返回 值 类 型 。 假 设 需要 创建 一 个 方法 ， 该 方法 把 一 个 集合 的 
表 N 个 元 素 复 制 到 一 个 新 的 集合 中 ， 之 后 返回 该 新 集合 。 如 果 使 

用 ArrayList， 那 就 等 同 于 镶 寞 了 静态 类 型 的 优势 。 如 果 传 

入 Stringcollection， 那么 返回 值 类 型 也 必须 

是 stringcollection。Sstring 类 型 成 了 该 方法 输入 的 要 系 ， 于 是 返回 值 
也 被 限制 到 了 string 类 型 。C# 1 对 这 个 问题 束手无策 ， 于 是 泛 型 出 场 
本 二 























2.1.2 ” 泛 型 降临 


解决 上 述 问题 的 办 法 就 是 采用 泛 型 List<T>。List<T> 是 一 个 集合 ， 其 中 T 
表示 集合 中 元 素 的 类 型 ， 在 我 们 的 例子 中 ，string 就 是 这 个 TT， 
此 List<string> 就 可 以 蔡 换 所 有 StringcoLlection2。 


2 还 有 一 种 解决 办 法 一 一 通过 接口 来 约束 返回 值 和 参数 类 型 ， 不 过 这 里 
不 做 探讨 ， 以 免 分 散 读 者 的 精力 。 








代码 清单 2-4 使 用 List<T> 创 建 并 打印 names 
static List<string> GenerateNames() 


List<string> names = new List<string>(); 
names.Add("Gamma" ) ， 
names.Add("Vlissides"); 

names .Add("Johnson"); 

names.Add( "Helm"); 

return names; 


} 

static void PrintNames(List<string> names) 

: foreach (string name in names) 
Console.writeLine(name); 

上 


List<T> 解 决 了 前 文 提 到 的 所 有 问题 。 


。 与 数组 不 同 ，List<T> 无 须 在 创建 前 先 获知 集合 的 大 小 。 

。 与 ArrayList 不 同 ， 在 对 外 提供 的 API 中 ， 一 切 表 不 元 素 类 型 之 处 省 
用 T 来 代 指 ， 这 样 我 们 就 能 知道 List<string> 的 集合 只 能 包含 String 
类 型 的 引用 。 如 果 癌 集合 添加 了 错误 类 型 的 元 素 ， 在 编译 时 就 会 报 
错 。 

。 与 stringcollection 等 类 型 不 同 ，List<T> 兼 窑 所 有 类 型 ， 省 去 了 生 
成 代码 以 及 处 理 返回 值 等 诸多 困扰 。 


使 用 泛 型 ， 还 可 以 解决 使 用 元 素 类 型 作为 方法 的 输入 类 型 这 一 问题 。 下 
面 将 介绍 更 多 术语 ， 以 便 进一步 深入 探讨 。 
1. 类 型 形 参 与 类 型 实 参 


形 参 (parameter) 和 实 参 (argument)〉 的 概念 ， 比 C# 泛 型 概念 出 现 
得 还 要 早 ， 其 他 一 些 语言 使 用 形 参 和 实 参 已 有 数 十 年 之 入。 声明 函 
数 时 用 于 描述 函数 输入 数据 的 参数 称 为 形 参 ， 函 数 调用 时 实际 传递 
给 函数 的 参数 称 为 实 参 。 图 2-1 措 述 了 二 者 的 关系 。 








图 2-1 函数 形 参 与 实 参 的 关系 


实 参 的 值 相当 于 方法 形 参 的 初始 值 ， 而 泛 型 涉及 两 个 参数 概念 : 类 
型 形 参 (type parameter) 和 类 型 实 参 (type argument) ， 相 当 于 把 
普通 形 参 和 实 参 的 思想 用 在 了 表示 类 型 信息 上 。 在 声明 泛 型 类 或 者 
泛 型 方法 时 ， 需 要 把 类 型 形 参 写 在 类 名 或 者 方法 名 称 之 后 ， 并 用 尖 
括 写 <> 包 围 。 之 后 在 声明 体 中 ， 束 可 以 像 普通 类 型 一 样 使 用 该 类 型 
形 参 了 《只 不 过 此 时 还 不 知道 具体 类 型 ) 。 


之 后 在 使 用 泛 型 类 或 谤 型 方法 的 代码 中 ， 需 要 在 类 型 名 或 方法 名 后 


同样 用 尖 括 号 包围 ， 给 出 具体 的 实 参 类 型 。 图 2-2 以 List<T> 为 例 呈 
现 了 二 者 的 关系 。 











图 2-2 ”类 型 形 参 与 类 型 实 参 之 间 的 关系 


设想 一 下 List<T> 的 完整 API， 包 括 全 部 的 方法 签名 、 属 性 等 。 当 使 
用 图 > 2 中 的 list 变 量 时 ，API 中 的 T 都 会 被 string 蔡 代 。 例 如 
List<T> 中 的 Add 方 法 ， 其 方法 签名 如 下 : 


public void Add(T item) 


如 果 在 Visual Studio 中 输入 List.Add(， 从 IntelliSense 的 智能 补 全 
和 有 :; 仿佛 item 参 数 在 声明 时 山 是 string 闫 型。 如 果 给 Add 方 法 传 入 
非 string 类 型 的 值 ， 就 会 引发 编译 时 错误 。 


图 2-2 是 关于 泛 型 类 的 示例 。 泛 型 也 可 以 用 于 方法 ， 在 方法 声明 中 
给 出 类 型 形 参 ， 之 后 就 可 以 在 方法 签名 中 使 用 这 些 类 型 形 参 了 。 而 
且 当 方法 声明 体 中 包含 其 他 方法 的 调用 寿 句 时 ， 这 些 类 型 形 参 还 可 
以 用 作 调 用 其 他 方法 的 类 型 实 参 。 代 码 清单 2-5 解 决 了 之 前 那个 巧 
而 未 决 的 问题 ， 以 静态 类 型 的 方式 把 一 个 集合 的 前 和 N 个 元 素 复 制 到 
为 一 个 新 集合 中 。 


代码 清单 2-5 集合 间 的 元 素 复 制 


public static List<T> CopyAtMost<T>( (本 行 及 以 下 2 行 ) 方法 声明 了 
List<T> input, int maxElements) 
{ 














int actualCount = Math.Min(input.Count, maxElements); 
List<T> ret = new List<T>(actualCount); <------ 在 方法 体 中 1 
for (int i = 0; i < actualCcount， I++) 





ret.Add(input[i]); 
} 


return ret,; 


3 


static void Main() 


{ 
List<int> numbers = new List<int>(); 
numbers.Add(5); 
numbers .Add(10); 
numbers .Add(20); 


List<int> firstTwo = CopyAtMost<int>(numbers, 2); <------ 
Console.writeLine(firstTwo.Count); 


} 


很 多 泛 型 方法 的 类 型 形 参 只 用 于 方法 签名 中 3， 也 不 用 作 类 型 实 
参 。 不 过 ， 用 类 型 形 参 来 表示 普通 形 参 的 类 型 与 返回 值 类 型 之 间 的 
关系 ， 是 泛 型 的 一 个 重要 作用 。 


同样 ， 当 声明 有 基 类 或 者 接口 时 ， 泛 型 形 参 也 可 以 用 作 基 类 或 者 接 
口 的 泛 型 实 参 ， 比 如 声明 泛 型 类 List<T> 实 现 自 泛 型 接口 


RE 














public class List<T> : IEnumerable<T> 


说 明 ”实践 中 实现 List<T> 时 不 仅仅 实现 了 这 一 个 接口 ， 上 面 
仅 是 一 个 简化 的 示例 。 


. 泛 型 类 型 和 泛 型 方法 的 度 


泛 型 类 型 或 泛 型 方法 可 以 声明 多 个 类 型 形 参 ， 只 需 在 尖 括 号 内 用 到 
号 把 它们 隅 开 即 可 ， 例 如 .NET 中 Hashtable 类 s 的 泛 型 声明 


public class Dictionary<TKey, TValue> 


泛 型 度 (arity) 是 泛 型 声明 中 类 型 形 参 的 数量 。 坦 白 说 ， 泛 型 度 这 

个 术语 ， 我 主要 将 其 用 于 描述 概念 ， 对 平时 编写 代码 用 处 不 是 很 

ne 过 了 解 这 个 概念 还 是 有 用 的 。 可 以 将 非 泛 型 的 声明 视 为 泛 型 
0 





泛 型 度 是 区 分 同名 泛 型 声明 的 有 效 指 标 。 比 如 前 面 提 到 C# 2 中 的 泛 
型 接口 TEnumerable<T>， 它 和 .NET 1.0 中 的 非 泛 型 接口 IEnumerable 
和 
下 所 示 : 











public void Method() {} <------ 非 泛 型 方法 〈 泛 型 度 为 0) 
public void Method<T>() {} <------ 泛 型 度 为 1 的 方法 
public void Method<T1，T2>() {} <------ 泛 型 度 为 2 的 方法 





当 声 明 同 名 但 度 不 同 的 泛 型 类 型 时 ， 这 些 类 型 并 不 一 定 是 同一 类 别 
的 ， 但 一 般 不 建议 这 么 做 。 假 如 同一 程序 集中 存在 如 下 同名 类 型 声 
明 ， 使 用 者 必然 军 头 转 同 : 


public enum IAmConfusing {} 

public class IAmConfusing<T> {} 

public struct IAmConfusing<T1, T2> {} 

public delegate void IAmConfusing<T1i, T2, T3> {} 
public interface IAmConfusing<T1i, T2, T3, T4> {} 


我 不 提倡 以 上 这 种 写法 ， 不 过 依然 存在 一 种 可 以 接受 的 情况 : 在 一 
个 非 泛 型 静态 类 中 ， 提 供 一 个 辅助 方法 ， 它 会 调用 其 他 同名 的 泛 型 
类 型 (静态 类 相关 内 容 请 参考 2.5.2 节 ) 。2.1.4 节 将 介绍 Tuple 类 ， 
该 类 用 于 创建 各 种 泛 型 Tuple 类 的 实例 。 


类 似 于 泛 型 类 型 ， 汉 型 方法 也 可 以 定义 同名 但 泛 型 度 不 同 的 方法 。 
这 种 方式 类 似 于 以 不 同 参数 来 定义 不 同 的 重 载 方法 ， 只 不 过 是 根据 
类 型 形 参 的 数量 来 定义 重 载 。 请 注意 ， 泛 型 度 可 以 用 于 区 分 同名 方 
人 

明 : 


public void Method<TFirst>() 1 
public void Method<TSecond>() {} <------ 编译 时 错误 : 不 能 仅 通 过 类 


这 两 条 语句 会 被 视 为 同一 个 方法 声明 ， 而 方法 重 载 规则 不 允许 使 用 
这 样 的 声明 。 如 果 想 让 以 上 声明 合法 ， 可 以 通过 其 他 方式 区 分 它们 
(比如 不 同 的 普通 参数 个 数 ) ， 不 过 鲜 有 这 样 的 操作 。 


另外 ， 在 一 个 方法 声明 中 ， 多 个 类 型 形 参 不 能 采用 相同 的 名 字 ， 这 
人 























public void Method<T，T>() {} <------ 编译 时 错误 : 重复 的 类 型 形 参 他 


而 对 于 类 型 实 参 来 说 ， 同 名 类 型 实 参 很 常用 ， 比 如 


Dictionary<string, string>。 


前 面 IAmconfusing 代 码 中 用 枚 举 类 型 作为 非 泛 型 类 的 示例 并 非 巧 
合 ， 接 下 来 它 会 派 上 用 场 。 


3 假设 我 定义 了 类 型 形 参 ,但 是 在 方法 签名 中 并 不 使 用 该 类 型 形 参 ， 这 
种 做 法 虽然 完全 可 行 ， 但 坚 无 意义 。 


2.1.3 泛 型 的 适用 范 

并 非 所 有 类 型 或 者 类 型 成 员 都 适用 泛 型 。 对 于 类 型 ， 这 很 好 区 分 ， 因 为 
可 供 声明 的 类 型 比较 有 限 : 枚 举 型 不 能 声明 为 泛 型 ， 而 类 、 结 构 体 、 接 
口 以 及 委托 这 些 可 以 声明 为 泛 型 类 型 。 

对 于 类 型 成 员 来 说 ， 就 没 那么 界限 分 明了 。 有 些 类 型 成 员 因 为 使 用 了 其 
他 泛 型 类 型 ， 看 似 泛 型 成 员 ， 但 实际 不 是 。 只 需 记 住 一 条 原则 : 判断 一 
个 声明 是 否 是 泛 型 声明 的 唯一 标准 ， 是 看 它 是 合 引 入 了 新 的 类 型 形 参 。 


方法 和 类 型 可 以 是 泛 型 ， 但 以 下 类 型 成 员 不 能 是 泛 型 : 
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下 面 举 一 个 貌似 泛 型 但 实际 不 然 的 例子 。 考 虑 如 下 沁 型 类 : 
public class ValidatingList<TItem> 


private readonly List<TItem> items = new List<TItem>(); <---- 


这 里 用 TItem 作 为 类 型 形 参 的 名 字 ， 是 为 了 把 它 和 List<T> 区 别 开 


来 。items 是 类 型 List<TItem> 的 一 个 字段 ， 它 将 TItem 用 作 List<T> 的 类 


型 实 参 。TItem 是 由 validatingList 类 声明 引入 的 类 型 形 参 ， 而 不 是 
由 items 声 明 本 映 引 入 的 。 


对 于 这 些 无 法 声明 为 泛 型 的 类 型 成 员 ， 通 种 很 难 想象 出 它们 如 何 才能 成 
为 泛 型 。 有 时 我 也 有 编写 泛 型 构造 右 或 者 泛 型 索引 器 的 需求 ， 可 最 后 往 
往 是 用 一 个 泛 型 方法 就 实现 了 同样 的 功能 。 

关于 泛 型 方法 的 调用 ， 前 文 仅仅 给 出 了 关于 类 型 实 参 的 粗略 描述 。 在 调 
用 泛 型 方法 时 ， 有 时 无 须 在 代码 中 给 出 类 型 实 参 ， 编 译 器 可 以 帮 我 们 决 
定 具 体 采 用 哪个 类 型 。 

2.1.4 方法 类 型 实 参 的 类 型 推断 

请 看 代码 清单 2-5 中 的 关键 片段 ， 其 泛 型 方法 声明 如 下 : 


public static List<T> CopyAtMost<T>(List<T> input, int maxElement 


在 main 方 法 中 ， 声明 一 个 List<int> 类 型 的 变量 numbers， 并 将 该 变量 作 
为 copyAtMost 方 法 的 调用 实 参 : 














List<int> numbers = new List<int>(); 


List<int> firstTwo = CopyAtMost<int>(numbers, 2); 


函数 调用 的 代码 已 加 粗 。copyAtMost 函 数 声明 了 一 个 类 型 形 参 ， 因 此 在 
调用 时 需要 给 它 传递 类 型 实 参 。 不 过 ， 在 调用 时 ， 可 以 省 略 类 型 实 参 ， 
如 下 所 示 ; 


List<int> numbers = new List<int>(); 


List<int> firstTwo = CopyAtMost(numbers, 2); 


从 编译 露 之 后 生成 的 于 代码 的 角度 讲 ， 这 两 种 调用 写法 完全 相同 。 这 里 
并 不 需要 明确 给 出 类 型 实 参 int， 因 为 编译 圳 可 以 上 自行 推 亲 。 推 类 的 依 
据 是 方法 调用 中 参数 列表 的 第 1 个 实 参 。 形 参 input 的 类 型 是 List<T>， 
其 对 应 实 参 的 类 型 是 List<int>， 因 此 编译 器 推 朵 T 的 实际 类 型 是 int。 


编译 器 只 能 推 凑 出 传递 给 方法 的 类 型 实 参 ， 但 推 基 不 出 返回 值 的 类 型 实 
参 。 对 于 返回 值 的 类 型 实 参 ， 要 么 显 式 地 全 部 给 出 ， 要 么 隐 式 地 全 部 省 
上 略 。 


尽管 类 型 推断 只 能 用 于 方法 ， 但 它 可 以 简化 泛 型 类 型 实例 的 创建 ， 例 

如 .NET 4.0 中 的 元 组 系列 。 元 组 系列 包含 了 一 个 非 泛 型 的 静态 类 Tuple 以 
及 一 批 泛 型 类 : Tuple<T1>、Tuple<T1，T2>、Tuple<T1，T2，T3> 等 。 静 
态 类 包含 了 一 组 重 载 create 工 厂 方法 : 


public static Tuple<T1i> Create<T1>(T1 item1) 


return new Tuple<T1>(item1); 


} 


public static Tuple<T1, T2> Create<T1, T2>(T1 Item1，T2 item2) 


return new Tuple<T1, T2>(item1i, item2); 


} 


这 种 写法 乍 一 看 似乎 没什么 意义 。 要 知道 ， 泛 型 类 型 推 怕 并 不 适用 于 构 
造 医 。 这 么 做 绅 在 在 创建 元 组 的 同时 利用 类 型 推 煌 。 直 接 调用 构造 髓 的 
实现 代码 比较 烦琐 : 


new Tuple<int, string, int>(10, "x", 20) 
但 是 使 用 静态 方法 配合 类 型 推 师 ， 代 码 就 简单 多 了 4: 


4 前 面 说 过 构造 圳 不 能 为 泛 型 ， 构 造 器 中 的 泛 型 参数 实际 上 是 来 目 它 所 
在 类 的 类 型 形 参 。 译 者 注 


Tuple.Create(10, "x", 20) 
这 是 一 个 非常 简单 实用 的 技巧 ， 利 用 它 编 写 泛 型 代码 轻松 而 愉悦 。 


关于 泛 型 类 型 推断 的 实现 原理 ， 这 里 不 做 深入 探讨 。C# 语 言 设计 团队 一 
直 致 力 于 让 类 型 推 关 能够 应 用 于 更 多 场景 ， 在 此 探索 过 程 中 ， 类 型 推 间 
的 实现 原理 也 在 不 断 更 新 变化 。 类 型 推 亲 和 重 载 决议 (overload 
resolution) 的 实现 原理 密切 相关 ， 而 它们 又 和 其 他 特性 有 交叉 《比如 继 
承 、 转 换 、 可 选 形 参 等 ) 。 这 是 C# 语 言 规范 中 较为 复杂 的 一 部 分 内 容 
5， 因 此 这 里 不 再 敬 述 。 


5 这 绝 非 一 已 之 见 。 就 在 本 书 编写 期 间 ， 重 载 决 议 这 部 分 的 技术 标准 央 
坏 了 ， 在 C# 5 ECMA 标 准 中 的 修复 尝试 也 失败 了 ， 只 能 等 到 下 一 个 版 本 
再 做 尝试 。 




















况且 理解 这 部 分 的 实现 细节 对 于 日 常 编码 帮助 不 是 很 大 。 大 体 说 来 ， 通 
常 只 会 遇 到 以 下 3 种 情况 。 


。 类 型 推 新 成 功 ， 并 得 到 预期 结果 。 

。 类 型 推 新 成 功 ， 但 没有 得 到 预期 结果 。 此 时 ， 只 需 显 式 指定 类 型 实 
参 或 者 对 某 些 实 参 转换 类 型 即 可 。 例 如 上 文 的 Tuple.create 方 法 ， 
如 果 目 标 结果 是 Tuple<int，object，int> 类 型 的 元 组 ， 就 显 式 指定 
类 型 实 参 : Tuple.Create<int, object, int>(10, "x", 20):; 或 者 
直接 调用 构造 器 new Tuple<int，object，int>( ..，); 或 者 调 
用 Tuple.create(10， (object) "x", 20)。 

。 类 型 推 师 在 编译 时 报错 。 有 时 只 需要 转换 参数 类 型 就 能 解决 。 例 如 
调用 Tuple.create(null，50)， 类 型 推断 会 失败 ， 因 为 null 本 号 不 
包含 任何 类 型 信息 ， 改 写成 Tuple.create((string) nulL1，59) 即 
可 。 如 遇 其 他 情况 ， 只 需 显 式 给 出 类 型 实 参 即 可 。 


依据 我 的 个 人 经 验 ， 无 论 采 取 哪 种 集 略 ， 对 代码 的 可 读 性 影响 者 不 大 。 
了 解 类 型 推断 的 原理 有 助 于 编码 者 进行 失败 预 判 ， 但 是 为 此 人 花费 大 量 时 
间 去 学 习 技 术 标准 ， 叉 似乎 有 点 得 不 偿 失 。 如 果 读 者 对 这 部 分 内 容 感 兴 
趣 ， 想 深入 研究 ， 我 也 不 会 强加 阻拦 ， 但 是 要 做 好 心理 准备 ， 你 可 能 会 
仿佛 置身 于 一 个 错 综 复 茶 的 迷宫 之 中 而 迷途 难 返 。 


0 0 
简单 易 用 。 


前 面 提 到 的 所 有 类 型 形 参 都 是 未 经 约束 的 ， 它 们 可 以 表示 任何 类 型 。 有 
时 对 于 未 个 天 天 形 参 ， 需 有 要 它 只 限于 符 定 闫 型 ， 这 联 有 了 闫 型 约束 的 概 
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2.1.5 ”类 型 约束 


在 泛 型 类 型 或 泛 型 方法 中 声明 类 型 形 参 时 ， 可 以 使 用 类 型 约束 来 限定 哪 
些 类 型 可 以 用 作 类 型 实 参 。 假 设 需要 一 个 用 于 格式 化 列表 元 素 的 方法 ， 
该 方法 可 以 确保 采用 特定 culture 而 不 是 默认 culture 来 格式 

化 。 IFormattable 接 口 有 一 个 满足 该 需求 的 方法 : ToString(string, 
IFormatProvider)， 可 是 该 如 何 确保 传 入 的 列表 符合 要 求 呢 ? 或 许 有 人 
打算 这 么 写 : 


static void PrintIitems(List<IFormattable> items) 








但 是 这 种 写法 几乎 没什么 用 ， 比 如 List<decimal> 类 型 的 值 就 无 法 传 给 
该 方法 。 尺 管 decimal 类 型 实现 了 IFormattable 接 口 ， 但 是 它 不 能 转换 
为 List<IFormattable> 类 型 。 


说 明 ”关于 List<decimal> 不 能 转换 为 List<IFormattable> 类 型 的 原 
因 ， 第 4 章 介 绍 泛 型 型 变 时 会 深入 探讨 ， 这 里 暂且 只 考虑 泛 型 约束 
的 内 容 。 


下 面 解 释 一 下 这 个 例子 中 类 型 约束 要 表达 的 信息 : PrintItems 方 法 参数 
需要 一 个 列表 ， 其 中 保存 的 是 某 个 类 型 的 元 素 ， 这 些 元 素 都 要 实现 
IFormattable 接 口 。 其 中 “ 某 个 类 型 ”表示 这 里 需要 使 用 泛 型 来 实现 , “元 
素 都 要 实现 IFormattable 接 口 ” 这 一 点 则 需要 类 型 约束 来 保证 ， 做 法 就 是 
在 函数 声明 的 末尾 添加 where 语 句 ， 参 考 如 下 代码 : 


static void PrintIitems<T>(List<T> items) where T : IFormattable 


使 用 泛 型 约束 ， 不 仅 可 以 约束 方法 实 参 的 值 类 型 ， 也 会 约束 方法 内 部 如 
何 操 作 和 使 用 T 类 型 的 值 。 通 过 约束 ， 编 译 右 就 可 以 知道 7 实现 了 
IFormattable 接 口 ， 于 是 才 会 允许 该 T 类 型 的 值 调 


用 IFormattable.ToString(string, IFormatProvider) 方 法 。 


代码 清单 2-6 ”使 用 类 型 约束 打印 items 


static void PrintIitems<T>(List<T> items) where T : IFormattable 











CultureInfo culture = CultureInfo.InvariantCulture,; 
foreach (T item in items) 


Console.writeLine(item.ToString(null, culture)); 


} 


如 果 没 有 类 型 约束 ， 那 么 item.Tostring 的 调用 方法 将 无 法 通过 编译 ， 
因为 编译 器 只 能 查找 到 System.0bject 下 的 Tostring 方 法 。 


类 型 约束 不 仅 适用 于 接口 ， 还 可 以 约束 以 下 类 型 。 
。 引用 类 型 约束 where T : class。 类 型 实 参 必须 是 一 个 引用 类 


型 。 (class 这 个 关键 字 容 易 引 起 误解 ， 它 表示 任何 引用 类 型 ， 包 
括 所 有 接口 和 委托 。) 








。 值 类 型 约束 一 where T : struct。 类 型 实 参 必须 是 非 可 空 值 类 型 
(结构 体 类 型 或 枚 举 类 型 ) 。 可 空 值 类 型 〈2.2 节 会 讲 到 ) 不 适用 
于 本 约束 。 

。 构造 器 约束 一 where T : new()。 类 型 实 参 必 须 是 公共 的 无 参 构 
造 器 。 该 约束 保证 了 可 以 通过 new T() 创 建 一 个 T 类 型 的 实例 。 

。 转换 约束 where T : SomeType。 这 里 的 SomeType 可 以 是 类 、 接 
口 或 者 其 他 类 型 形 参 : 

o where T : Control 
o where T : IFormattable 
o where T1 : T2 


类 型 约束 可 以 组 合 使 用 ， 而 组 合 规则 比较 复杂 。 一 般 说 来 ， 如 果 违 反 了 
相关 规则 ， 编 译 器 会 给 出 明确 的 错误 信息 。 


人 











public void Sort(List<T> items) where T : IComparable<T> 


以 上 约束 把 rT 用 作 泛 型 接口 Icomparable<T> 的 类 型 实 参 ， 这 样 sort 方 法 就 
可 以 调用 items 中 元 素 的 compareTo 方 法 来 比较 大 小 了 ，compareTo 方 法 正 
是 来 自 Icomparable<T> 接 口 的 实现 。 


T first = navy 
T second = ...; 
int comparison = first.CompareTo(second); 


我 个 人 使 用 接口 的 类 型 约束 频 度 最 高 。 上 共 体 使 用 哪个 类 型 约束 ， 主 要 取 
决 于 编码 类 型 。 


当 一 个 声明 中 存在 多 个 类 型 形 参 时 ， 每 个 类 型 形 参 都 可 以 有 各 目的 类 型 
约束 ， 如 下 所 示 : 











TResult Method<TArg, TResult>(TArg input) <------ 具有 两 个 类 型 形 参 TA 
where TArg : IComparable<TArg> <------ TArg 必 须 实现 IComparable: 
where TResult : class, new() <------ TResult 必 须 是 具有 无 参 构造 器 | 





泛 型 相关 内 容 已 近 尾声 ， 还 剩 两 个 话题 需要 探讨 ， 我 们 从 C# 2 与 类 型 相 
关 的 两 个 运算 符 开始 。 


2.1.6” default 运算 符 和 typeof 运 算 符 


早 在 C# 1 时 代 ，typeof() 运 算 符 整 出 现 了 ， 它 接收 一 个 类 型 名 称 作为 唯 
一 操作 数 。C# 2 加 入 了 default() 运 算 待 ， 并 且 略 微 扩 展 了 typeof 的 用 


途 。 


default 运 算 符 的 功能 比较 简单 : 它 是 一 元 运算 符 ， 其 操作 数 是 类 型 名 
或 类 型 形 参 ， 返 回 值 是 该 类 型 的 默认 值 。 当 声明 了 一 个 字段 ， 但 是 没有 
为 该 字段 立刻 赋值 时 ， 该 字段 的 值 就 是 默认 值 。 如 果 是 引用 类 型 ， 默 认 
值 是 一 个 nu11 引 用 ; 如 果 是 非 可 空 值 类 型 ， 将 返回 对 应 类 型 的 “0 

值 ”(0、0.0、0.0m、false、UTF-16 编 码 的 单元 0 等 ) ; 如 果 是 可 空 值 类 
型 ， 则 返回 该 类 型 的 nul1 值 。 


default 运 算 符 可 以 用 于 类 型 形 参 以 及 提供 了 类 型 实 参 〈 也 可 以 是 类 型 
形 参 ) 的 泛 型 类 型 。 例 如 在 泛 型 方法 中 声明 了 一 个 类 型 形 参 T， 下 面 几 
种 形式 均 合 法 : 


e default(T) 

e default(int) 

e default(string) 

e default(List<T>) 

e default(List<List<string>>) 


default 运 算 符 返回 值 的 类 型 与 操作 数 的 类 型 一 致 。default 各 与 泛 型 类 
型 形 参 一 起 使 用 ， 因 为 对 于 非 泛 型 类 型 ， 可 以 通过 其 他 方式 获得 
default 值 。 例 如 定义 了 一 个 本 地 变量 后 ， 无 法 确定 该 变量 在 以 后 的 代 
码 逻 辑 中 是 否 一 定 会 被 赋值 ， 于 是 我 们 给 该 变量 先 赋 一 个 初始 默认 值 。 
下 面 举例 说 明 : 


public T LastOrDefault<T>(IEnumerable<T> source) 








T ret = default(T); <------ 声明 了 一 个 局 部 变量 ， 并 将 T 的 默认 值 赋 给 该 | 
foreach (T item in source) 


ret = item; <------ 使 用 序列 的 当前 元 素 蔡 换 局 部 变量 值 


return ret; <------ 返回 最 后 一 个 赋值 的 元 素 值 


所 


























typeof 运 算 符 的 使 用 相对 复杂 一 些 。 考 虑 以 下 几 种 常见 情形 : 


不 涉及 泛 型 ， 例 如 typeof(string); 

涉及 泛 型 ， 但 是 不 涉及 类 型 形 参 ， 例 如 typeof(List<int>); 

仅 涉 及 类 型 形 参 ， 例 如 typeof(T); 

typeof 操 作 数 中 有 泛 型 ， 而 且 泛 型 作为 类 型 形 参 出 现 ， 例 如 
typeof(List<TItem>)， 它 出 现在 声明 了 TItem 类 型 形 参 的 方法 体内 


部 ; 
。 涉及 泛 型 ， 但 是 操作 数 中 并 没有 出 现 类 型 实 参 ， 例 如 


typeof(List<>)。 


其 中 第 一 个 场景 最 简单 ， 而 且 用 法 从 未 变 过 。 对 于 其 他 场景 ， 需 要 仔细 
考虑 ， 尤其 最 后 -个 还 引入 了 新 语法 。 typeof 运 算 符 的 返回 值 是 Type 次 
型 的 值 ， 而 且 Type 类 在 经 过 扩展 之 后 可 以 文 持 泛 型 。 那 么 上 述 几 种 情况 
都 各 上 自 返 回 什 么 值 呢 ? 需要 考虑 很 多 情形 ， 比 如 下 面 这 几 种 。 


。 如 果 在 包含 List<T> 定 义 的 程序 集中 获取 它 的 类 型 ， 那 么 结果 
征 List<T>， 不 包含 任何 具体 的 类 型 实 参 ， 这 被 称 为 泛 型 类 型 定 


3 
。 如果 在 List<int> 对 象 上 调用 GetType() 方 法 ， 那 么 得 到 的 结果 将 包 


含 int 这 个 类 型 实 参 的 信息 。 
。 假设 有 一 个 泛 型 类 定义 如 下 : 如 果 要 获取 它 基 类 的 类 型 ， 得 到 的 类 


型 将 包含 一 个 具体 的 类 型 形 参 (string) 和 一 个 类 型 形 参 形式 的 类 
型 实 参 (CT) 。 




















class StringDictionary<T> : Dictionary<string, T> 


诚然 ， 上 面 这 些 逻 辑 真 的 很 复 森 ， 但 这 也 确实 是 类 型 机 制 的 天 性 使 然 。 
使 用 Type 类 提供 的 很 多 方法 和 属性 ， 能 做 到 在 泛 型 类 型 定义 和 提供 了 具 
体 类 型 实 参 的 类 型 之 间 转 换 。 


下 面 继 续 介 绍 typeof 运 算 符 。 要 理解 typeof 运 算 符 ， 一 个 简单 的 例子 
是 typeof(List<int>)， 其 返回 值 是 List<int> 的 Type 值 ， 结果 与 调用 new 
List<int>().GetType() 相 同 。 


接 下 来 讨论 typeof(T) 。 该 表达 式 返回 的 是 调用 代码 中 T 类 型 实 参 的 
Type。 它 的 返回 值 永 远 是 一 个 封闭 的 、 己 构造 的 类 型 ， 技 术 规 范 中 将 其 
描述 为 一 个 真正 不 包含 任何 类 型 形 参 的 类 型 。 尺 管 我 通常 会 尽 可 能 完 
使 用 术语 来 解释 概念 ， 但 是 泛 型 相关 术语 《比如 开放 、 封 团 、 有 具体 、 绑 





定 、 未 绑 定 等 ) 都 太 过 难于 理解 ， 而 且 在 实际 编码 中 几乎 用 不 到 。 后 面 
会 前 释 “ 封 困 ” 和 “具体 ”这 两 个 术语 ， 至 于 另外 几 个 术语 ， 本 书 将 不 会 涉 
及 。 


下 面 通过 有 具体 示例 展示 typeof(T) 以 及 typeof(List<T>)， 其 中 的 
PrintType 汉 型 方 潜 仙 页 打印 typeof(T) 和 typeof(List<T>) 的 执行 结 
果 ，main 方 法 通过 两 个 类 型 实 参 调用 该 方法 。 


代码 清单 2-7 打印 typeof 的 执行 结 


static void PrintType<T>() 
{ 





Console.WwriteLine("typeof(T) = {0}", typeof(T)); <------ 打印 t 
Console.WriteLine("typeof(List<T>) = {0}", typeof(List<T>)); 


static void Main() 





PrintType<string>(); <------ 使 用 string 作 为 类 型 实 参 调用 方法 
PrintType<int>(); <------ 使 用 int 作 为 类 型 实 参 调用 方法 





以 上 代码 的 执行 结果 如 下 : 


typeof(T) = System,String 
typeof(List<T>) = System.Collections.Generic.List 1i[System.String 
typeof(T) = System.Int32 
typeof(List<T>) = System.Collections.Generic,.List 1[System.Int32] 


重点 关注 : 第 一 次 方法 调用 时 ， 代 码 运 行 上 下 文中 T 的 类 型 实 参 

为 string， 因 此 执行 typeof(T) 等 同 于 执行 typeof(string); 同样 ， 执 
行 typeof(List<T>) 等 同 于 执行 typeof (List<string>)。 接 下 来 以 int 作 
为 类 型 实 参 再 次 调用 方法 ， 所 得 结果 也 与 typeof(int) 和 
typeof(List<int>) 相 同 。 泛 型 类 型 或 泛 型 方法 内 部 代码 执行 时 ， 类 型 形 
参 总 是 指向 一 个 封闭 的 、 己 构造 的 类 型 。 


这 个 例子 还 展示 了 使 用 反射 时 泛 型 类 型 的 命名 格式 。List `1 表 示 这 是 一 
个 名 为 List 的 泛 型 类 型 ， 其 泛 型 度 为 1〈 只 有 一 个 类 型 形 参 ) ， 后 面 方 
括号 中 的 内 容 是 类 型 实 参 。 


最 后 讨论 typeof (List<>)。 该 表达 式 看 起 来 缺少 类 型 实 参 。 这 种 写法 只 





有 在 typeof 运 算 符 中 才 有 效 ， 而 且 指 同 了 泛 型 类 型 定义 。 对 于 度 为 1 的 
涝 型 ， 书 写 格式 为 TypeName<>， 如 果 参 数 多 于 1 个 ， 每 增加 一 个 参数 就 
增加 一 个 皖 号 。 比 如 要 获取 Dictionary<TKey，TvValue> 的 泛 型 类 型 定 
义 ， 就 写成 typeof(Dictionary<,>); 要 获取 Tuple<T1，T2，T3> 的 定 
义 ， 则 是 typeof(Tuple<, ,>)。 


理解 泛 型 类 型 定义 和 封闭 的 、 已 构造 类 型 之 间 的 区 别 ， 对 于 本 章 最 后 
个 话题 至 天 重要 |; 类 型 的 初始 化 过 程 以 及 如 何 处 理 类 型 范围 (静态 ) 状 


Cy 








2.1.7” 泛 型 类 型 初始 化 与 状态 
前 面 typeof 的 调用 结果 显示 : List<int> 和 List<string> 是 由 同一 个 泛 型 
类 型 定义 构造 出 来 的 两 个 类 型 ， 在 使 用 时 会 被 当 作 不 同类 型 来 对 待 ， 而 
且 在 初始 化 和 处 理 静 态 字段 时 ， 也 要 当 作 不 同类 型 处 理 。 每 个 封闭 的 、 
已 构造 类 型 都 会 被 单独 初始 化 ， 并 且 拥 有 各 目的 静态 域 。 代 码 清 单 2-8 
是 一 个 非常 简单 的 、 非 线程 安全 的 泛 型 计数 器 。 

代码 清单 2-8 探索 泛 型 中 的 静态 字段 


class GenericCounter<T> 





private static int value; <------ 每 个 封闭 的 、 已 构造 类 型 对 应 一 个 字 |] 
static GenericCounter() 


Console.writeLine("Initializing counter for {0}", typeof( 


public static void Increment() 


value+t++; 


public static void Display() 
Console.writeLine("Counter for {0}: {1}", typeof(T), valu 


} 


class GenericCounterDemo 


{ 


static void Main() 


1 


GenericCounter<string>.Increment(); <------ 触发 GenericCou 
GenericCounter<string>.Increment(); 
GenericCounter<string>.Display(); 
GenericCounter<int>.Display(); <------ 触发 GenericCounter< 
GenericCounter<int>.Increment(); 
GenericCounter<int>.Display(); 


l 
代码 执行 结果 如 下 : 


Initializing counter for System.String 
Counter for System.String: 2 
Initializing counter for System.Int32 
Counter for System.Int32: 0 
Counter for System.Int32: 1 


以 上 执行 结果 中 有 两 点 需要 关注 。 首 先 ，Genericcounter<string> 和 
Genericcounter<int> 的 值 是 相互 独立 的 ， 其 次 ， 静 态 构造 器 被 执行 了 两 
次 : 每 个 封闭 的 、 已 构造 类 型 各 目 执行 了 一 次 。 如 果 没 有 提供 静态 构造 
器 ， 融 无 法 保证 这 两 个 类 型 之 间 初 始 化 的 顺序 ， 但 是 本 质 

上 Genericcounter<string> 和 Genericcounter<int> 还 是 两 个 独立 的 类 


2 


这 个 问题 还 可 以 进一步 复杂 化 ， 将 泛 型 类 型 岁 套 。 像 下 面 这 个 类 定义 这 
样 ， 类 型 实 参 的 不 同 组 合 将 得 到 不 同 的 类 型 。 


class Outer<TOuter> 





{ 
class Inner<TInner> 
{ 
static int value; 
} 
} 


如 果 使 用 int 和 string 作 为 类 型 实 参 ， 得 到 的 下 面 几 个 类 型 将 都 是 独立 
的 ， 且 各 上 自 拥有 value 字 段 : 


e Outer<string>.Inner<string> 
e Outer<string>.Inner<int> 


e Outer<int>.Inner<string> 
e Outer<int>.Inner<int> 


上 面 这 种 情况 是 比较 少见 的 。 这 里 只 需 知道 ， 重 要 的 是 那些 已 经 完全 确 
定 的 类 型 (包括 叶子 类 型 和 封闭 类 型 的 所 有 类 型 实 参 在 内 ) ， 这 个 问题 
就 没有 那么 复杂 了 。 


以 上 就 是 关于 泛 型 的 全 部 内 容 。 泛 型 是 C# 2 截至 目前 最 庞大 的 一 个 特性 
了 ， 也 是 对 C# 1 的 一 项 重大 改进 。 下 面 介绍 可 空 值 类 型 ， 此 项 特性 正 古 
基于 泛 型 建立 的 。 


2.2 ”可 衬 值 类 型 


Tony Hoare 于 1965 年 在 Algol 语 言 中 首次 引入 了 nul11 引 用 的 概念 ， 后 来 他 
把 这 项 举措 称 为 “十 亿美 金 的 过 失 ”。 无 数 开 发 人 员 饱 受 
NullReferenceException (.NET) 、NullpPointerException (Java) 等 的 
折磨 。 由 于 此 类 问题 的 普遍 性 ，Stack Overflow 上 有 大 量 与 之 相关 的 典 
型 问题 。 既 然 可 裕 特 性 如 此 声名 狠 藉 ， 为 何 C# 2 以 及 .NET 2.0 要 引入 可 
空 值 类 型 呢 ? 在 深入 可 空 值 类 型 的 实现 细节 之 前 ， 首 先 看 看 它 可 以 解决 
哪些 问题 ， 以 前 义 是 如 何 解 决 这 些 问 题 的 。 


2.2.1 目标: 表达 信息 的 缺失 


有 时 我 们 需要 一 种 变量 来 保存 茶 种 信息 ， 但 是 相关 信息 并 不 需要 时 刻 
都 “在 场 ”， 例 如 以 下 几 种 场景 。 


。 为 客户 订单 建 模 ， 订 单 中 包含 公司 信息 一 栏 ， 但 并 不 是 所 有 人 都 以 






































公司 名 义 提交 订单 。 
。 个 人 信息 中 包含 生 华 年 月 ， 但 并 不 是 每 个 人 都 有 


。 为 休 蒜 产品 进行 筛选 器 建 借 ， 算 选 条 件 中 包含 产品 的 价格 范围 ， 但 
古 客 户 可 能 并 没有 给 出 产品 的 最 高 价格 。 


上 述 场景 都 指向 了 一 个 需求 ， 那 束 是 表示 “未 提供 的 值 ”。 即 便当 前 我 们 
能 够 获得 所 有 信息 ， 但 依然 需要 为 信息 缺失 的 可 能 情况 建 模 ， 因 为 在 茶 
些 场景 中 ， 获 得 的 信息 可 能 是 不 完整 的 。 在 第 2 个 场景 中 ， 我 们 甚至 可 
能 连 某 个 人 的 出 生日 期 也 不 知道 ， 可 能 系统 刚好 没有 登记 或 者 是 其 他 情 























况 。 有 时 我 们 还 需要 详细 区 分 哪些 信息 是 
0 
足够 了 。 


对 于 引用 类 型 ，C# 语 言 已 经 提供 了 表示 其 信息 缺失 的 方法 : nul11 引 用 。 
假设 有 一 个 company 类 和 一 个 order 类 ，order 类 中 有 一 个 与 公司 信息 关联 
的 引用 。 当 客户 没有 指定 具体 的 公司 信息 时 ， 束 可 以 把 该 引用 设 

为 null。 


而 对 于 值 类 型 ，C# 1 中 并 没有 相应 的 表示 nul1 值 的 方法 ， 当 时 普遍 采用 
下 面 两 种 方式 实现 。 


。 当 数 据 缺 失 时 ， 采 用 预 设 值 。 比 如 第 3 个 场景 中 的 价格 科 选 器 ， 当 
没有 指定 最 高 价格 时 ， 可 以 采用 decimal.Maxvalue 作 为 默认 的 最 大 


值 。 
单独 维护 一 个 布尔 型 的 标志 来 表示 其 他 字段 是 实际 值 还 是 默认 值 ， 
这 样 在 访问 字段 前 先 检 查 该 标志 ， 即 可 知道 该 字段 当前 值 是 否 
效 。 


然而 以 上 两 种 方式 都 不 太 理 想 。 第 1 种 方式 挤 压 了 有 效 值 的 范围 
(decimal 类 型 还 没什么 太 大 问题 ， 但 如 果 是 byte 类 型 ， 束 必须 窗 新 所 
有 取 值 范围 ) 。 第 2 种 方式 则 会 导致 很 多 见 余 和 逻辑 重复 。 


更 严重 的 是 ， 这 两 种 方式 都 容易 出 错 ， 因 为 二 者 都 需要 在 使 用 前 检查 变 
量 。 不 经 过 检查 ， 束 无 法 知晓 变量 是 否 为 有 效 值 ， 之 后 代码 可 能 一 直 默 
默 地 使 用 错误 的 数据 ， 错 误 地 执行 ， 并 把 这 些 错误 传递 给 系统 其 他 部 

分 。 这 种 “静默 ”的 失败 是 最 棘手 的 ， 因 为 很 难 追 中 和 撤销 。 相 对 而 言 ， 

能 够 在 执行 路 径 中 明确 抛 出 异常 会 好 很 多 。 


可 空 值 类 型 封装 了 前 面 第 2 种 方式 : 为 每 个 值 类 型 维护 一 个 额外 的 标 
志 ， 用 该 标志 来 指示 当前 值 是 否 可 用 。 封 闭 这 一 步 是 关键 : 它 把 对 值 类 
型 访问 的 安全 性 和 易 用 性 结合 了 起 来 。 如 采 当 前 访问 的 值 是 无 效 的 ， 抛 
出 异常 即 可 。 可 空 值 类 型 维持 了 原 有 类 型 的 对 外 使 用 方式 不 变 ， 还 具备 
表达 信息 缺失 的 能 力 。 这 样 的 实现 方式 既 减 轻 了 开发 人 员 的 编码 负担 ， 
也 保证 了 类 库 开 发 人 员 设 计 API 时 符合 语法 标准 。 


有 了 这 些 基础 概念 ， 下 面 看 一 下 framework 和 CLR 为 实现 可 空 值 类 型 提 
供 了 哪些 支持 。 讲 解 完 这 部 分 内 容 后 ， 还 会 介绍 C#3 引 入 的 一 些 特性 ， 这 





会 缺失 的 ， 哪 些 信息 是 不 
能 够 表达 出 “信息 缺失 ”就 


定 
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些 特性 可 以 简化 可 空 值 类 型 的 使 用 方式 。 
2.2.2 ”CLR 和 人 framework 的 文 持 : Nullable<T> 结 构 体 


可 空 值 类 型 特性 背后 的 核心 要 素 是 Nullable<T> 结 构 体 。Nullable<T> 的 


一 个 早期 版 本 如 下 所 示 : 


public struct Nullable<T> where T : struct <------ 泛 型 结构 体 ， 其 类 2 
{ 








private readonly T value; 
private readonly bool hasVvalue; 











public Nullable(T value) <------ 提供 了 值 的 构造 器 
{ 





this.value = value; 
this.hasValue = true; 


2 


public bool HasValue { get { return hasValue; } } <------ 用 于 


public T Value (本 行 及 以 下 16 行 ) 访问 值 ， 如 果 值 不 存在 则 抛 出 异常 
{ 





get 
if (!hasVvValue) 
throw new InvalidOperationException(); 
ee value; 


以 上 代码 显示 : 该 结构 体 声明 了 唯一 的 构造 器 ， 并 将 hasvalue 的 初始 值 
设 为 true， 该 结构 体 类 型 还 隐 售 了 一 个 无 参 构造 器 〈 结 构 体 类 型 的 共 
性 ) 。 无 参 构 造 右 则 会 将 hasvalue 的 初始 值 设 为 false， 将 value 的 初始 
值 设 为 T 类 型 的 默认 值 : 


Nullable<int> nullable = new Nullable<int>(); 
Console .WriteLine(nullable.HasValue); <------ 打印 结果 : False 














Nullable<T> 中 的 where T : struct 约 束 表 示 T 可 以 是 除 Nullable<T> 外 的 
任意 值 类 型 ， 原 始 类 型 、 枚 举 、 系 统 内 置 结构 体 和 用 户 自 定义 结构 体 等 


都 满足 该 约束 ， 因 此 以 下 写法 均 合 法 : 


Nullable<int> 

Nullable<FileMode> 

Nullable<Guid> 

Nullable<LocalDate> (来 自 Noda Time 项 目 ) 


以 下 写法 皆 非 法 : 


。 Nullable<string> (string 是 引用 类 型 ) ; 

。 Nullable<int[]>《 数 组 是 引用 类 型 ， 与 内 部 元 素 是 否 是 值 类 型 无 
关 ) ; 

Nullable<ValueType> (ValueType 本 里 并 不 是 值 类 型 )， 
Nullable<Enum> (CEnum 本 喘 也 不 是 值 类 型 ) ; 
Nullable<Nullable<int>> (Nullable<int> 是 可 空 类 型 本 身 ) ; 
Nullable<Nullable<Nullable<int>>> (将 可 空 类 型 髓 套 也 没有 


用 ) 。 


在 Nullable<T> 中 ，T 称 为 基础 类 型 ， 比 如 Nullable<int> 的 基础 类 型 
日 . 
ELnt。 


至 此 ， 已 经 可 以 在 没有 CLR、framework 或 语言 的 支持 下 ， 通 过 
Nullable<T> 类 解决 之 前 那个 价格 盘 选 器 的 问题 了 : 


public void DisplayMaxPrice(Nullable<decimal> maxPriceFilter) 





If (maxPriceFilter.HasValue) 

Console.writeLine("Maximum price: {0}", maxPriceFilter.Va 
else 

Console.writeLine("No maximum price set."); 


} 


以 上 代码 可 谓 良 质 ， 使 用 变量 前 会 对 其 进行 检查 。 如 果 没 有 检查 变量 或 
者 检查 错 了 对 象 会 怎么 样 呢 ? 即 使 这 样 也 无 须 担 忧 ， 因 为 当 Hasvalue 
为 false 时 ， 任 何 访问 maxpriceFilter 的 操作 都 会 引发 异常 。 


说 明 虽然 此 前 已 经 强调 过 ， 不 过 现在 仍 有 必要 重申 一 下 : 语言 的 








进步 不 仅仅 体现 在 让 编码 变 得 更 简单 ， 还 体现 在 能 够 让 开发 人 员 编 
写 出 更 健全 的 代码 ， 或 者 可 以 降低 错误 后 果 的 严重 性 。 


另外 ，Nullable<T> 结 构 体 还 提供 了 如 下 一 些 方法 和 运算 符 。 


。 无 参数 的 GetvalueorDefault() 方 法 负 贡 返回 结构 体 中 的 值 ， 如 果 
HasValue 是 false， 则 返回 默认 值 。 

带 参 数 的 GetvalueorDefault(T defaultvalue) 方 法 同样 负责 返回 结 
如 果 Hasvalue 是 false， 则 返回 由 实 参 指定 的 默认 


NulLlable<T> 重 写 了 object 类 的 Equals(object) 和 GetHashcode() 方 
法 ， 使 其 行为 更 加 明确 : 首先 比较 Hasvalue 属 性 ， 当 两 个 比较 对 象 
的 HasValue 均 为 true 时 ， 再 比较 value 属 性 是 否 相 等 。 

可 以 执行 从 T 到 Nullable<T> 的 隐 式 类 型 转换 。 访 转换 总 是 会 返回 对 
应 的 可 空 值 ， 并 且 其 Hasvalue 为 true。 该 隐 式 转换 等 同 于 调用 带 参 
数 的 构造 器 。 

可 以 执行 从 Nullable<T> 到 T 的 显 式 类 型 转换 。 当 Hasvalue 为 true 时 
返回 封装 于 其 中 的 值 ， 当 Hasvalue 为 false 时 则 抛 出 
InvalidOperationException。 该 转换 等 同 于 使 用 value 属 性 。 


后 面 讲 到 语言 文 持 部 分 时 ， 还 会 继续 讨论 类 型 转换 。 至 此 ，CLR 需 要 做 
的 事情 ， 就 是 保证 struct 类 型 约束 。CLR 针 对 可 空 值 类 型 还 提供 了 一 项 
帮助 ， 装 箱 (boxing) 。 


装 箱 行为 

当 涉 及 装 箱 行为 时 ， 可 空 值 类 型 和 非 可 空 值 类 型 的 行为 有 所 不 同 。 当 非 
可 空 值 类 型 被 装 箱 时 ， 返 回 结 果 的 类 型 就 是 原始 的 装 箱 类 型 ， 例 如 : 
int x = 5; 

object 0 = x; 

o 是 对 “ 装 箱 int” 对 象 的 引用 。 在 C# 中 ,，“ 北 箱 int” 和 int 之 间 的 区 别 通 常 
是 不 可 见 的 : 如 果 执 行 o.GetType()， 返 回 的 Type 值 会 和 typeof(int ) 的 
结果 相同 。 诸 如 C++/CLI 这 样 的 语言 ， 则 允许 开发 人 员 对 装 箱 前 后 的 类 
型 加 以 区 分 。 

然而 可 空 值 类 型 并 没有 直接 对 等 的 装 箱 类 型 。Nullable<T> 类 型 的 值 进 
行 装 箱 后 的 结果 ， 视 Hasvalue 属 性 的 值 而 定 : 








e。 如 果 Hasvalue 为 false， 那 么 结果 是 一 个 nul11 引 用 ; 
e。 如 果 HasValue 为 trrue， 那 么 结果 是 “ 装 箱 T ”对象 的 引用 。 


代码 清单 2-9 展 现 了 以 上 两 点 。 
代码 清单 2-9 ”可 空 值 类 型 的 装 箱 效果 


Nullable<int> noValue = new Nullable<int>(); 
object novalueBoxed = noValue; <------ 值 的 装 箱 操 作 ，HasValue 为 false 
Console.writeLine(noValueBoxed == null); <------ 打印 结果 : True 。 装 / 








Nullable<int> someValue = new Nullable<int>(5); 
object someValueBoxed = someValue; <------ 值 的 装 箱 操作 ，HasValue 为 tt 
Console.WriteLine(someValueBoxed.GetType()); <------ 打印 结果 : Syst 


这 正 是 理想 的 装 箱 行为 ， 不 过 它 有 一 个 比较 奇怪 的 副作用 : 

在 System.0bject 中 声明 的 6etType() 方 法 为 非 虚 方 法 (不 能 重 写 ) ， 对 
某 个 值 类 型 调用 GetType() 方 法 时 总 会 先 触发 一 次 装 箱 操作 。 该 行为 或 
多 或 少 会 影响 效率 ， 但 是 还 不 至 于 造成 困扰 。 如 果 对 可 空 值 类 型 调 

用 GetType()， 要 么 会 引发 NuLLReferenceException， 要 么 会 返回 对 应 的 
非 可 衬 值 类 型 ， 如 代码 清单 2-10 所 示 。 


代码 清单 2-10 可 空 值 类 型 调用 GetType 方 法 会 得 到 奇特 的 结 


Nullable<int> noValue = new Nullable<int>(); 
// Console.WriteLine(noValue.GetType()); <------ 会 殷 出 NullReferen 














Nullable<int> someValue = new Nullable<int>(5); 
Console.writeLine(someValue.GetType()); <------ 打印 结果 : System.In 


除了 framework 和 CLR 对 可 空 值 类 型 的 支持 ，C# 语 言 还 有 其 他 设计 来 保 
证 可 空 值 类 型 的 易 用 性 。 


2.2.3 ”语言 层面 支持 


如 果 当 初 C# 2 发布 时 只 提供 了 struct 类 型 约束 来 让 编译 器 只 知道 可 空 值 
类 型 ， 人 简直 不 可 想象 。C# 团 队 完 全 可 以 给 可 空 值 类 型 特性 提供 这 种 最 基 
本 的 支持 。 当 初 大 只 提供 了 最 基本 的 支持 ， 不 知 会 有 多 少 局 促 、 困 顿 ， 
那些 为 了 将 可 空 值 类 型 融入 语言 标准 而 增加 的 特性 歹 更 令 人 心 生 敬意 
了 。 下 面 从 一 个 最 简单 特性 开始 : 可 空 值 类 型 命名 的 简化 。 














1. ?后 级 


Nullable<T> 类 型 有 一 个 简化 版 的 写法 ， 束 是 在 类 型 名 后 添加 ?后 
级 。 两 种 写法 效果 等 同 ， 而 且 该 写法 对 简 版 类 型 名 (int、double 
等 ) 和 全 版 类 型 名 都 适用 。 下 面 4 个 声明 完全 等 价 : 








o Nullable<int> x; 

o Nullable<INt32> x; 

o int? x; 

oO INt32? x; 

上 述 4 种 写法 任意 组 合 、 混 用 都 没有 问题 ， 它 们 产生 的 开 代 人 码 没 有 
任何 区 别 。 在 实际 编码 中 ， 我 一 贯 使 用 ?写法 ， 不 过 不 同 的 团队 或 
许 有 不 同 的 编码 习惯 。 由 于 ?在 文字 内 容 中 会 引起 卜 义 ， 因 此 之 后 
我 只 在 代码 中 使 用 ? 符 写 ， 其 他 地 方 仍 使 用 Nullable<T>。 


这 应 该 是 C# 语 言 中 最 简单 的 一 项 改进 了 ， 本 章 后 续 内 容 也 将 员 
彻 “ 编 写 更 简洁 的 代码 ”这 一 主题 。? 后 级 用 于 简化 类 型 的 表达 ， 下 
一 个 特性 则 用 于 简化 值 的 表达 。 





2. null 字 面 量 


C# 1 中 null 表 达 式 永远 代 指 一 个 nu11 引 用 。 到 了 C#2，nul1l 的 含义 
扩展 了 : 或 者 表示 一 个 nul1 引 用 ， 或 者 表示 一 个 Hasvalue 为 false 的 
可 空 类 型 的 值 。nul1 值 可 用 于 赋值 、 函 数 实 参 以 及 比较 等 任何 地 
方 。 有 一 点 需要 强调 : 当 nul11 用 于 可 衬 值 类 型 时 ， 它 表示 Hasvalue 
为 false 的 可 空 类 型 的 值 ， 而 不 是 nu11 引 用 。nu11 引 用 和 可 空 值 类 
型 不 容易 辨 明 ， 例 如 以 下 两 行 代码 是 等 价 的 : 


int? x = new int?(); 








int? x = null; 


一 般 我 更 倾 回 于 使 用 null (第 2 种 写法 ) 而 不 是 显 式 调用 无 参 构造 
J 不 过 当 涉 及 比较 逻辑 时 ， 这 两 种 写法 就 不 容易 抉择 了 ， 例 
0D: 


if (x != null) 





if (x.HasValue) 
对 于 书写 习惯 上 的 偏好 ， 我 自己 也 很 难 一 以 贯 之 。 不 是 说 保持 一 致 


的 编码 风格 不 重要 ， 只 是 就 这 部 分 内 容 来 说 ， 确 实 影响 不 大 。 可 目 
由 切换 编码 风格 ， 无 须 考 处 兼容 性 问题 。 











. 转换 


前 面 讲 过 ， 存在 从 T 到 Nullable<T> 的 隐 式 类 型 转换 ， 以 及 从 
Nullable<T> 到 T 的 显 式 类 型 转换 。 此 外 ，C# 语 言 还 允许 链 式 转换 。 
对 于 任意 两 个 非 可 空 的 值 类 型 s 和 T， 如 果 存 在 从 s 到 T 的 类 型 转换 
(例如 从 int 转 换 到 decimal1) ， 那 么 以 下 类 型 转换 都 是 合法 的 : 


o Nullable<s> 到 Nullable<T> 的 类 型 转换 ( 显 式 转换 或 隐 式 转 
换 ， 视 s 到 T 的 转换 类 型 而 定 ); 

o Ss 到 Nullable<T> 的 类 型 转换 (同上) ; 

o Nullable<S> 到 T 的 显 式 类 型 转换 。 


上 述 转换 的 工作 原理 比较 显而易见 : 其实 是 将 s 到 T 按 照 要 求 进行 转 
换 ， 并 为 其 填充 了 nul1 值 。 这 种 通过 填充 nul1 值 扩展 已 有 操作 的 过 
程 叫 作 提升 〈lifting) 。 


有 一 点 需要 注意 无论 是 可 空 值 还 是 非 可 空 值 ， 都 可 以 进行 显 式 类 
型 转换 ，LINQ to XML 就 很 好 地 利用 了 该 特性 。 它 可 以 显 式 地 

将 XElement 类 型 转换 为 int 或 者 Nullable<int> 类 型 。LINQ to XML 
中 有 很 多 操作 ， 当 碍 找 一 个 不 存在 的 元 素 时 会 返回 一 个 nul1 引 用 ， 
然后 把 nu11 引 用 转换 为 Nullable<int>。 该 过 程 涉及 把 nu11 引 用 转换 
为 nul1 值 ， 同 时 引入 “可 空 ”。 整 个 过 程 不 会 抛 出 任何 异常 。 可 是 如 
果 把 一 个 空 的 xElement 引 用 强制 转换 为 非 可 空 的 ijnt 类 型 ， 束 会 引 
发 异常 。 由 于 这 两 种 转换 的 存在 ，LINQ to XML 处 理 可 选 元 素 和 必 
选 元 素 都 变 得 更 安全 、 更 轻松 。 


对 于 类 型 转换 操作 ， 我 们 既 可 以 使 用 C# 预 定义 的 类 型 转换 操作 ， 也 
可 目 定义 类 型 转换 。 其 他 那些 原本 用 于 非 可 空 类 型 的 操作 ， 操 作 的 
范围 也 扩展 至 可 空 类 型 。 














本 岳 升 运算 侍 
C# 人 允许 对 以 下 运算 符 进 行 重 载 。 


一 元 运算 符 : +、 ++、-、--、!、~、true、false。 
三 元 运 伍 付 GY yt we 0 | 
等 从 和 运 生生: 汪 3 

大 东区 人 


使 用 以 上 运算 符 重 载 非 可 空 类 型 T 时 ，Nullable<T> 也 会 重 载 相同 的 
运算 符 ， 不 过 操作 数 类 型 和 返回 值 类 型 会 和 非 可 空 类 型 有 所 区 别 ， 

这 些 都 被 称 为 提升 运算 符 。 无 论 是 预定 义 运算 符 〈 比 如 数值 类 型 的 
加 法 运算 符 ) ， 还 是 用 户 自 定 义 运算 符 《〈 比 如 为 pateTime 类 添加 一 
个 TimeSpan 运 算 符 ) 都 适用 ， 此 外 还 需要 遵循 以 下 规则 : 


true 和 false 运 算 符 不 能 被 提升 ， 但 二 者 很 少 用 ， 因 此 影 啊 不 


大 ; 

只 有 操作 数 是 非 可 空 值 类 型 的 运算 符 才 能 被 提升 

对 于 一 元 运算 符 和 二 元 运算 符 ( 等 价 运算 符 和 关系 运算 符 除 
外 ) ， 原 运算 符 的 返回 类 型 必须 是 非 可 空 的 值 类 型 ， 

对 于 等 价 运算 符 和 关系 运算 符 ， 原 运算 符 的 返回 类 型 必须 
是 boo1 类 型 ; 

o 作用 于 Nullable<boo1> 的 & 和 | 运算 符 具有 单独 定义 的 行为 ， 稍 


后 介绍 。 


对 于 所 有 运算 符 来 说 ， 操 作 数 的 类 型 都 成 了 对 应 的 可 空 等 价 类 型 。 
对 于 一 元 操作 数 和 二 元 操作 数 ， 返 回 类 型 也 成 为 可 空 类 型 。 如 果 任 
意 一 个 操作 数 为 nul1， 那 么 返回 值 也 为 nul1。 等 价 运算 符 和 关系 运 
算 符 可 以 保证 返回 类 型 是 非 可 空 的 布尔 型 。 进 行 等 价 操作 时 ， 两 

个 nul1 被 视 作 相等 ， 而 一 个 nul1 和 任意 一 个 非 nul1 值 是 不 相等 的 。 

对 于 关系 运算 符 ， 当 任意 一 个 操作 数 为 空 时 ， 总 是 返回 false。 当 

两 个 操作 数 均 为 非 空 时 ， 执 行 方式 与 原 运算 符 相 同 。 


这 些 规则 听 起 来 可 能 比较 复杂 ， 但 多 数 情 况 下 它们 的 执行 结果 不 会 
超出 我 们 的 预期 。 接 下 来 用 int 来 说 明 ， 因 为 int 有 众多 预定 义 运算 
从 《而 且 类 型 简单 ) ， 用 它 举 例 再 好 不 过 了 。 表 2-1 列 举 了 一 些 相 
关 的 表达 式 、 提 升 运算 符 及 其 结果 。 假 定 共 有 3 个 变 


量 : four、five 和 nullInt， 它们 的 类 型 都 是 Nullable<int>， 对 应 
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的 值 与 变量 名 一 致 。 
表 2-1 问 可 空 整数 应 用 提升 运算 符 的 例子 


fals 








该 表 中 最 让 人 不 解 的 应 该 是 最 后 一 行 : 为 什么 null 值 小 于 等 于 力 外 
一 个 null 值 ， 其 结果 会 是 false 呢 ?而 且 第 7 行 显示 二 者 相等 的 命题 
为 真 。 尽 管 这 个 结果 很 怪异 ， 但 是 根据 我 的 个 人 经 验 ， 在 实际 编码 
中 并 不 会 导致 问题 。 前 面 讲 运算 符 提 升 需要 章 循 的 规则 时 ， 提 过 
Nullable<boo1> 这 个 类 型 与 其 他 类 型 的 行为 有 所 不 同 。 














. 可 空 逻辑 


真 值 表 ， 是 用 于 列举 布尔 逻辑 中 所 有 可 能 输入 的 组 合 和 对 应 结果 的 
表 。 学 习 Nullable<boo1> 类 型 逻辑 ， 也 可 以 采用 相同 的 办 法 。 只 不 
过 输入 值 除了 true 和 false， 还 需要 加 上 nu11。 还 好 条 件 逻 辑 运 算 

符 〈&& 运 算 符 和 || 运 算 符 ) 不 适用 于 Nullable<boo1> 类 型 ， 省 去 不 
少 事 。 


表 2-2 是 Nullable<boo1> 全 部 4 个 多 辑 运 算 符 的 真 值 表 。 其 中 与 运算 





符 〈&) 和 或 运算 符 〈|1) 具有 特殊 行为 。 非 运算 符 〈!) 和 异 或 运 
算 符 (^) 与 其 他 提升 运算 符 的 规则 相同 。 列 表 中 额外 规则 不 适用 
于 Nullable<boo1> 类 型 的 情况 都 已 加 粗 。 


表 2-2 Nullable<boo1> 运 算 符 真 值 表 








理解 这 些 规则 有 一 个 简单 方法 : 可 以 把 boo1? 类 型 的 值 看 作 * 某 种 程 
度 的 可 能 ”把 输入 中 的 null 看 作 一 个 变量 ， 如 果 结 果 取 决 于 该 变 
量 的 值 ， 那 么 结果 一 定 是 nul1。 例 如 表 2-2 第 3 行 表达 式 true & y， 
当 且 仅 当 y 为 true 时 ， 表 达 式 的 结果 才 是 true。 因 此 ， 如 果 y 的 值 
是 nul1， 则 其 结果 是 nul1。 而 对 于 表达 式 true | y， 无 论 y 的 值 是 什 


么 ， 其 结果 总 是 true。 


就 提升 运算 符 和 可 空 值 逻 辑 的 原理 而 言 ，C#i 语 言 和 SQL 语言 在 处 
理 null 值 问题 上 存在 两 处 轻微 的 冲突 : C# 1 的 nul1 引 用 和 SQL 的 
NULL 值 。 绝 大 部 分 情况 下 二 者 并 不 会 发 生 冲 突 ; C# 1 没有 为 nu113 引 
用 设计 逻辑 运算 符 ， 因 此 在 C# 中 使 用 早期 类 SQL 语言 的 结果 没有 问 
题 ， 但 当 涉 及 比较 操作 时 ， 二 者 的 矛盾 就 凸显 了 。 在 标准 SQL 中 ， 
如 果 参 与 比较 ( 仪 就 大 于 、 等 于 、 小 于 而 言 ， 的 两 个 值 中 有 一 个 
是 NuLL， 则 其 结果 不 可 预知 ，C# 2 则 规定 比较 操作 的 结果 不 能 
为 nul1， 两 个 nul1 值 相等 。 


提升 运算 符 的 执行 结果 是 C# 特 有 的 


本 节 所 讨论 的 提升 运算 符 、 类 型 转换 以 及 Nullable<bool> 逻 辑 
等 特性 都 是 由 C# 编 译 器 提供 的 ， 而 不 是 由 CLR 或 framework 本 











号 提供 的 。 如 果 使 用 ildasm 工 具 检查 上 述 可 空 值 运 算 符 的 代 
码 ， 就 会 友 现 是 编译 器 创建 了 所 有 下 代码 来 进行 空 值 检查 ， 并 
做 出 相应 处 理 。 


因此 ， 不 同 语言 处 理 nul1 值 的 方式 会 有 所 不 同 。 如 果 需 要 在 基 
于 .NET 平 台 的 不 同 语言 之 间 移 植 代 码 ， 就 需要 格外 小 心 了 。 例 
如 Visual Basic 中 提升 运算 符 的 行为 就 更 接近 SQL: 当 x 或 y 

为 null 时 ，x < y 的 结果 也 为 nul1。 


下 面 介绍 另 一 个 可 以 应 用 于 可 空 值 类 型 的 运算 符 ， 其 行为 更 符合 我 
们 的 直观 预期 ， 只 需要 把 nul1 引 用 的 行为 照搬 到 nul1 值 上 即 可 。 





. as 运算 符 与 可 空 值 类 型 

在 C# 2 之 前 ，as 运 算 符 只 能 用 于 引用 类 型 ， 到 了 C# 2，as 运 算 符 也 
可 以 用 于 可 空 值 类 型 了 。 该 运算 符 的 返回 值 为 一 个 可 空 类 型 的 值 : 
当 原始 引用 的 类 型 为 nu11 或 与 目标 类 型 不 匹配 时 ， 返 回 nul1 值 ， 或 
者 返回 一 个 有 意义 的 值 ， 示 例如 下 : 


static void PrintValueAsInt32(object 0) 
{ 





int? nullable = 0 as int?; 
Console.writeLine(nullable.HasValue ? 
nullable.Value.ToString() : "null"); 








} 
PrintValueAsInt32(5); <------ 打印 结果 : 5 
PrintValueAsInt32("some string"); <------ 打印 结果 : null 


使 用 as 运算 符 ， 仅 需 一 步 操作 就 能 把 任意 引用 安全 地 转换 成 一 个 
值 。 转 换 结束 后 ， 通 党 还 需 手动 检查 结果 是 任 为 nu11。 在 C#1 时 
代 ， 转 换 类 型 后 ， 还 需要 用 is 运 算 符 来 判断 转换 是 否 成 功 。 这 种 方 
式 不 太 优 雅 ， 本 质 上 等 同 于 请 求 CLR 执 行 了 两 次 相同 的 类 型 检查 。 


说 明 ”对 可 空 类 型 使 用 as 运算 符 ， 性 能 出 奇 地 低 。 大 部 分 情况 
下 ， 这 不 算 太 大 的 问题 〈 还 是 要 比 IO 操 作 效率 高 ) ， 但 是 依 
然 比 采用 is 运算 符 完 成 转换 性 能 低 。 我 在 几乎 所 有 framework 
和 编译 需 的 组 合 上 都 试 过 上 述 操作 ， 慢 得 确 乎 无 疑 。 





对 于 目标 结果 是 Nullable<T> 类 型 的 表达 式 来 说 ，as 是 很 方便 的 运 
算 符 而且 C# 7 对 大 部 分 可 空 值 类 型 采用 模式 匹配 〈 详 见 第 12 
章 ) ， 故 使 用 as 运算 符 是 更 优 的 解决 方案 。 最 后 ，C# 2 还 引入 了 一 
个 全 新 的 运算 符 ， 用 于 优雅 地 处 理 nul1 值 。 


. 空 合并 运算 符 ?? 


在 实际 编码 中 ， 总 会 有 使 用 可 空 值 类 型 的 需求 : 当 一 个 表达 式 运算 
结 末 为 nul1 时 ， 为 变量 提供 一 个 默认 值 。C# 2 引入 了 ?? 运 算 符 来 解 
决 上 述 问 题 ， 称 为 空 合并 运算 符 。 


?? 是 一 个 二 元 运算 从，first ?? second 表 达 式 的 计算 分 为 以 下 几 个 
步 又: 

(1) 计算 first 表 达 式 ; 

(2) 若 结果 不 为 nul1， 则 整个 表达 式 的 结果 等 于 first 的 计算 结果 ; 


(3) 若 结 果 为 空 ， 则 继续 计算 second 表 达 式 ， 整 个 表达 式 的 结果 
为 second 的 计算 结果 。 


上 述 过 程 只 是 粗略 的 描述 ， 话 言 规范 中 的 正式 规则 还 包括 了 处 
理 first 与 second 之 间 的 类 型 转换 。 不 过 类 型 转换 的 过 程 对 于 该 运 
算 符 的 大 部 分 使 用 场景 来 说 不 重要 ， 因 此 这 里 略 去 相关 内 容 。 如 有 
兴趣 继续 探究， 可 参考 相关 语言 规范 。 


上 述 规则 中 有 一 个 重点 需要 强调 : 如 果 第 1 个 操作 数 的 类 型 是 可 空 
值 类 型 ， 同 时 第 2 个 操作 数 是 第 1 个 操作 数 对 应 的 非 可 空 值 类 型 ， 整 
个 表达 式 的 类 型 就 是 该 非 可 空 值 类 型 。 例 如 以 下 代码 是 合法 的 : 














以 上 代码 中 ，a 是 可 空 值 类 型 ,表达 式 a ?? b 的 值 可 以 不 经 类 型 转 
换 直 接 赋 值 给 非 可 空 类 型 的 c。 这 样 的 赋值 之 所 以 合法 ， 是 因为 b 是 
非 可 空 的 ， 所 以 整个 表达 式 的 返回 值 将 不 可 能 为 mul11。 男 外 ，?? 表 
达 式 还 可 以 自 组 合 使 用 ， 例 如 x ?? y ?? z， 如 果 x 为 空 就 计算 y; 


如 果 x 和 y 都 为 空 ， 就 计算 z。 


C# 6 引入 了 空 值 条 件 运算 符 ?.〈 详 见 10.3 节 ) ， 访 运算 符 便 利 了 作 
为 表达 式 结果 的 空 值 处 理 。 在 代码 中 把 *. 和 ?? 运 算 符 组 合 使 用 ， 可 
以 发 挥 出 处 理 空 值 的 强大 作用 。 一 如 既往 ， 对 于 新 技术 的 使 用 要 遵 
循 适 度 原 则 。 如 果 过 度 应 用 运算 符 使 得 代码 可 读 性 变 着 ， 不 如 考 碟 
将 单条 语句 拆 分 为 多 条 ， 优 先 增强 可 读 性 。 


对 C# 2 的 可 空 值 类 型 的 介绍 就 到 此 为 止 。 我 们 已 经 介绍 完 C# 2 最 重 
要 的 两 个 特性 ， 后 续 还 会 讨论 硝 干 午 大 特性 和 一 些小 的 特性 ， 下 面 
先 介 组 委 托 。 


6 虽然 等 价 运算 符 和 关系 运算 符 也 属于 二 元 运算 符 ， 但 在 行为 上 与 其 他 
二 元 运算 符 有 所 人 不同， 因此 需要 单独 列 出 。 


2.3 简化 委托 的 创建 


委托 这 一 特性 存在 的 目的 自 其 诞生 之 日 起 就 从 未 改变 过 ， 那 就 是 封装 目 
标 代 码 。 封 装 好 的 代码 可 以 在 应 用 程序 中 进行 传递 ， 并 根据 需要 执行 
(要 保证 参数 和 返回 值 的 类 型 安全 ) 。 在 C# 1 时 代 ， 委 托 基 本 上 用 于 事 
件 处 理 和 启动 线程 。 即 使 在 2005 年 C# 2 推出 之 后 ， 这 一 状况 也 没有 发 生 
太 大 变化 。 直 到 2008 年 LINQ 问 世 ，C# 开 发 人 员 才 开始 适应 这 种 把 函数 
传 来 传 去 的 编程 方式 。 


C# 2 提供 了 3 种 创建 委托 实例 的 新 方式 ， 同 时 文 持 声 明 泛 型 委托 ， 比 如 
EventHandler<TEventArgs> 和 Action<T>。 首先 介绍 方法 组 转换 。 


2.3.1 方法 组 转换 
所 谓 方法 组 ， 就 是 一 个 或 多 个 同名 方法 。 可 以 说 ，C# 程 序 员 每 天 都 在 
不 知 不 党 中 使 用 方法 组 ， 因 为 每 调用 一 次 方法 就 是 对 方法 组 的 一 次 使 
用 ， 参 见 如 下 代码 : 


Console.writeLine("hello"); 




















表达 式 console .WriteLine 就 是 一 个 方法 组 。 之 后 编译 器 会 根据 该 方法 的 
调用 实 参 从 方法 组 中 选择 合适 的 重 载 方法 进行 调用 。 除 了 方法 调用 ，C# 


1 还 将 方法 组 用 于 委托 创建 表达 式 ， 作 为 创建 委托 实例 的 唯一 方式 。 假 
设 有 如 下 方法 : 


private void HandleButtonClick(object sender, EventArgs e) 
可 以 如 下 所 示 创 建 EventHandler7 实 例 : 


7 假设 EventHandler 签 名 为 : public delegate void 
EventHandler(object sender, EventArgs e)。 


EventHandler handler = new EventHandler(HandleButtonClick); 


C# 2 通过 方法 组 转换 简化 了 委托 实例 的 创建 过 程 : 只 要 委托 的 签名 与 方 
法 组 中 任何 一 个 重 载 方法 兼容 ， 该 方法 组 就 可 以 隐 式 地 转换 为 该 委托 类 
型 。2.3.3 节 会 详细 探讨 兼容 性 ， 目 前 只 采用 方法 签名 完全 一 致 的 委托 来 
举例 。 

像 前 面 EventHandler 的 例子 ，C# 2 可 以 将 其 形式 简化 为 : 


EventHandler handler = HandleButtonClick; 
事件 的 订阅 和 取消 也 可 以 采用 相同 的 方式 : 
button.Click += HandleButtonClick; 


简化 版 的 代码 和 使 用 创建 委托 表达 式 的 代码 最 终 会 生成 相同 的 中 间 代 
码 ， 唯 一 的 区 别 是 前 者 更 简洁 。 如 今 很 少 有 使 用 创建 委托 表达 式 的 代码 
了 。 方 法 组 转换 的 出 现 简 化 了 开发 人 员 创建 委托 实例 的 工作 ， 而 接 下 来 
的 匿名 方法 特性 在 这 方面 表现 更 佳 。 





2.3.2 ”匿名 方法 


本 章 不 会 深入 探讨 匿名 方法 ， 因 为 匿名 函数 的 继任 者 lambda 表 达 式 才 是 
真正 的 主角 。lambda 表 达 式 由 C# 3 推出 。 如 果 lambda 表 达 式 问世 在 先 ， 
大 概 就 不 会 有 匿名 方法 了 。 


话 虽 如 此 ， 但 是 C# 2 引入 的 匿名 方法 也 曾 帮 助 我 以 一 种 全 新 的 方式 来 认 
识 委 托 。 使 用 匿名 方法 ， 无 须 在 创建 委托 实例 前 预先 编写 妨 一 个 实体 方 
法 8， 只 需 在 委托 中 创建 内 联 代码 即 可 。 大 体 步骤 是 : 使 用 delegate 关 











键 字 ， 添 加 实 参 列 表 《〈 可 选 ) ， 然 后 在 大 括号 内 编写 需要 的 代码 ， 例 如 
在 事件 触 友 时 问 控 制 台 输出 消 轧 这 个 功能 : 


8 这 个 方法 最 终 还 是 会 出 现在 于 代码 中 。 
EventHandler handler = delegate 


Console.writeLine("Event raised"); 


了 


不 会 立刻 调用 console.writeLine， 而 是 创建 了 一 个 委托 。 只 有 委托 被 调 
用 时 ， 才 会 调用 console.writeLine。 我 们 可 以 通过 传 入 合适 的 参数 ， 打 
印 sender 和 事件 参数 这 些 信息 : 


EventHandler handler = delegate(object sender, EventArgs args ) 


{ 
Console.writeLine("Event raised. sender={0}; args={1}", 
sender .GetType(), args.GetType( )); 


}; 


然而 匿名 方法 的 真正 威力 ， 要 等 它 用 作 闭 包 〈closure) 时 才能 发 挥 出 
来 。 闭 包 能 够 访问 其 声明 作用 域内 的 所 有 变量 ， 即 使 当 委托 执行 时 这 些 
变量 已 经 不 可 访问 。 后 面 介绍 lambda 表 达 式 时 ， 会 详细 讲解 闭 包 这 个 概 
念 〈 包 括 编译 器 如 何 处 理财 包 ) ， 现 在 只 需 参 考 如 下 不 

例 。AddclickLogger 方 法 接收 两 个 参数 : contro1 和 message， 该 方法 给 
control 的 Click 事件 处 理 堪 添加 委托 实例 ， 该 实例 根据 message 来 

问 control 输 出 内 容 。 


void AddClickLogger(Control control, string message) 








control.cClick += delegate 
Console.WriteLine("Control clicked: {0}", message); 


} 


message 作 为 AddclickLogger 方 法 的 参数 ， 是 可 以 被 匿名 方法 “ 捕 

获 ” 的 。AddclickLogger 方 法 本 丑 并 不 执行 该 匿名 方法 ， 它 只 是 把 匿名 方 
法 作为 啊 应 器 添加 给 click 事 件 。 当 匿名 方法 真正 开始 执行 

时 ，AddclickLogger 方 法 早已 经 返回 了 。 那 么 方法 的 参数 为 何 还 能 访问 
呢 ? 简 而 言 之 ， 是 由 编译 器 默默 完成 了 枯燥 的 代码 生成 工作 。3.5.2 节 会 





详细 介绍 lambda 表 达 式 是 如 何 捕 获 变 量 的 。 这 里 的 EventHandler 并 无 特 
殊 之 处 ， 它 只 是 framework 中 一 个 常 驻 、 常 用 的 委托 类 型 。C# 2 关于 委 
a 目前 还 剩 兼容 性 这 项 没有 介绍 ， 之 前 的 方法 组 转换 中 提 


2.3.3 ”委托 的 兼容 性 

在 C# 1 中 创建 委托 实例 时 ， 创 建 实例 的 方法 与 委托 的 返回 值 类 型 和 参数 
(包括 ref/out 修 饰 符 ) 必须 完全 一 致 。 假 设 有 如 下 委托 声明 和 方 
法 : 


public delegate void Printer(string message); 














public void PrintAnything(object obj) 


Console.WriteLine(ob]j); 


之 后 创建 一 个 Printer 委 托 的 实例 来 把 printAnything 方 法 封装 起 来 。 看 
似 应 该 没什么 问题 ，Printer 传 入 的 参数 肯定 是 string 引 用 ， 而 string 类 
型 的 引用 可 以 通过 一 致 性 转换 变 为 object 类 型 的 引用 ， 但 C# 1 不 允许 这 
种 方式 ， 因 为 二 者 的 参数 类 型 不 匹配 。 到 了 C# 2， 就 可 以 在 创建 委托 表 
达 式 和 方法 组 转换 中 进行 上 述 转换 了 。 


Printer pi 
Printer p2 


此 外 ， 还 可 以 使 用 委托 来 创建 男 外 一 个 委托 ， 条 件 是 二 者 的 签名 要 莱 
容 。 假 设 还 有 一 个 和 PrintAnything 兼 容 的 委托 : 


public delegate void Generalprinter(object obj); 
之 后 可 以 使 用 GeneralPrinter 实 例 来 继续 创建 printer 委 托 的 实例 : 


GeneralPrinter generalPrinter = ...; <------ 任意 创建 GeneralPrintel 
Printer printer = new Printer(generalPrinter)， <------ 构建 一 个 Priit 


编译 器 允许 以 上 写法 ， 因 为 printer 的 任何 合法 实 参 都 可 以 安全 地 用 
作 GeneralPrinter 的 实 参 ， 返 回 值 类 型 也 同 理 : 


public delegate object 0bjectProvider(); (本 行 及 以 下 1 行 ) 无 参 委 托 返 [ 


new Printer(PrintAnything); 
PrintAnything,; 











public delegate string StringProvider(); 





StringProvider stringProvider = <------ 任意 创建 StringProvidei 
ObjectProvider objectProvider = 米 行 及 以 下 1 行 》 创 建 一 个 0bjectProvit 
new ObjectProvider(stringProvider); 


重申 一 下 : 以 上 代码 之 所 以 安全 ， 原 因 是 stringProvider 的 返回 值 类 型 
和 objectProvider 的 返回 值 类 型 兼容 。 


不 过 有 时 上 述 规则 并 不 能 如 我 们 所 愿 。 参 数 或 返回 值 之 间 的 兼容 性 必须 
满足 一 致 性 转换 规则 ， 这 样 才能 保证 执行 期 变量 值 不 变 ， 而 如 下 所 示 的 
代码 就 不 能 通过 编译 


public delegate void Int32Printer(int x); (本 行 及 以 下 1 行 ) (接受 32/E€ 
public delegate void Int64Printer(long x); 











Int64Printer int64Printer = ..,; <------ 任意 创建 Int64Printer 的 方式 ] 
Int32Printer int32Printer = 米 行 及 以 下 1 行 ) (出 错 ! 不 能 在 Int32Printe 
new Int32Printer(int64Printer); 


这 十 因为 两 个 委托 的 签名 不 兼容 : 尽管 从 int 到 long 类 付 存 在 隧 式 天 于 
转换 ， 但 它 不 符合 一 致 性 转换 的 要 求 。 编 译 器 有 无 可 能 在 后 台 创 建 一 个 
方法 来 蔡 我 们 完成 类 型 转换 呢 ? 很 可 惜 这 里 没有 。 如 果 编 译 器 能 蔡 我 们 
完成 类 型 转换 ， 将 会 为 开发 助力 不 少 ，4.4 节 会 讲 到 。 


请 注意 ， 虽 然 兼 容 委托 看 似 泛 型 型 变 ， 但 二 者 实际 上 是 不 同 的 特性 。 抛 
开 其 他 方面 ， 委 托 中 的 封装 本 质 上 是 创建 了 一 个 新 的 实例 ， 而 不 是 把 已 
有 委托 看 作 不 同类 型 的 实例 。 在 介绍 完 相 关 特 性 的 全 部 内 容 之 后 ， 会 详 
细 探 讨 这 一 话题 ， 现 阶段 读 才 只 需要 知道 两 者 是 不 同 的 即 可 


以 上 就 是 C# 2 的 委托 特性 的 全 部 内 容 。 方 法 组 转换 如 今 依旧 应 用 广泛 ; 
兼容 特性 不 知 不 觉 中 已 融入 日 常 编码 ; 匿名 方法 的 使 用 频 度 大 幅 下 降 ， 
因为 lambda 表 达 式 几乎 取代 了 匿名 方法 的 所 有 功能 ， 但 是 其 团 包 特性 功 
能 的 强大 令 我 动容 至 今 。 一 个 特性 的 出 现 会 引发 男 一 个 特性 ， 这 种 情况 
在 C# 中 廊 见 不 鲜 。 下 面 就 先 领略 一 下 C# 5 异步 特性 的 先驱 : 迭代 器 。 


2.4 迭代 器 


C# 2 中 只 4 有 很 少 一 部 分 接口 有 特定 的 语言 文 持 ， 其 中 IDisposable 接 口 通 
过 using 语 句 获得 支持 ;语言 还 保证 了 数组 相关 的 接口 ;而 枚 举 接口 有 























语言 层面 的 支持 。IEnumerable 一 直 都 有 foreach 语 句 来 支持 枚 举 类 型 的 
消费 。C# 2 还 扩展 了 泛 型 版 本 的 枚 举 接口 IEnumerable<T>， 该 泛 型 接口 
比较 直观 。 


枚 举 接口 代表 了 元 素 的 序列 。 对 序列 的 常规 操作 ， 无 外 平生 产 和 消费 序 
列 。 无 论 是 泛 型 接口 还 是 非 泛 型 接口 ， 如 果 选 择 手动 实现 ， 无 疑 既 繁复 
又 易 出 错 ， 因 此 C# 2 引入 了 一 个 新 特性 一 ”人 迭代 器 来 简化 该 过 程 。 
2.4.1 从 代 器 简介 


迭 代 器 是 包含 欠 代 器 块 的 方法 或 者 属性 。 友 代 融 块 本 质 上 是 包含 yield 
return 或 yield _ break 语句 的 代码 ， 只 能 用 于 以 下 返回 类 型 的 方法 或 属 
性 : 




















IEnumerable 
IEnumerable<T> (T 可 以 是 类 型 形 参 ， 也 可 以 是 普通 类 型 ) 
IEnumerator 
IEnumerator<T> 〈T 可 以 是 类 型 形 参 ， 也 可 以 是 普通 类 型 ) 


根据 友 代 堪 的 返回 类 型 ， 每 个 迭代 器 都 有 一 个 生成 类 型 〈yieldtype) 。 
如 果 返 回 类 型 是 非 泛 型 接口 ， 那 么 生成 类 型 是 object; 如 果 返 回 类 型 是 
泛 型 接口 ， 那 么 生成 类 型 是 该 泛 型 接口 实 参 的 类 型 ， 比 如 
IEnumerator<string> 的 生成 类 型 是 string。 

yield return 语 句 用 于 生成 返回 序列 的 各 个 值 ，yield break 语 句 用 于 终 
止 返回 序列 。 其 他 一 些 语言 《比如 Python) 也 有 类 似 的 结构 ， 有 时 称 为 
生成 器 (generator) 。 


下 面 展示 一 个 简单 的 从 代 器 ， 用 它 来 进一步 探究 迭代 器 的 原理 ， 其 中 
yield return 语 句 已 加 粗 。 


代码 清单 2-11 一 个 生成 整 型 值 的 简单 方法 


static IEnumerable<int> CreateSimpleIterator() 








yield return 10; 
for (int i = 0; i < 3; i++) 


yield return 工 ; 


} 
yield return 20; 


有 了 以 上 方法 ， 束 可 以 在 foreach 循 环 中 遍历 其 执行 结果 了 : 
foreach (int value in CreateSimpleIterator()) 


Console.WriteLine(value); 


循环 的 打印 结果 如 下 : 


到 目前 为 止 ， 还 没什么 特别 之 处 。 这 段 代码 还 可 以 有 更 简单 的 替代 实 
现 : 创建 一 个 List<int>， 把 yield return 都 蔡 换 成 Add()， 最 后 返回 该 
列表 。 两 种 实现 方式 循环 打印 的 结果 完全 相同 ， 但 执行 过 程 却 天 差 地 
别 : 迭代 器 是 延 运 执行 的 。 


2.4.2 ”延迟 执行 


延迟 执行 (也 称 延迟 计算 ) 属于 lambda 演 算 的 一 部 分 ， 于 20 世 纪 30 年 代 
被 提出 。 其 基本 思想 十 分 简单 : 只 在 需要 获取 计算 结果 时 执行 代码 。 当 
然 ， 延 迟 执行 的 应 用 范围 远 不 止 于 和 迭代 右 ， 但 是 目前 了 解 这 些 就 够 了 。 


为 了 阐释 清楚 代码 是 如 何 执行 的 ， 如 下 所 示 扩 展 以 上 代码 : 采用 while 
循环 来 重新 实现 与 原 foreach 循 环 大 致 相同 的 罗 辑 。 人 简单 起 见 ， 还 使 用 
了 using 语 法 糖 来 保证 Dispose 方 法 的 自动 调用 。 

代码 清单 2-12 扩展 foreach 循 环 


IEnumerable<int> enumerable = CreateSimpleIterator(); <------ 调用 
using (IEnumerator<int> enumerator = (本 行 及 以 下 1 行 ) 从 IEnumerable 
enumerable.GetEnumerator()) 

















while (enumerator.MoveNext()) <------ 如 果 存 在 下 一 个 元 素 ， 则 移动 型 


int value = enumerator.Current; <------ 获取 当前 值 
Console.writeLine(value); 


dg 
} 


如 果 读 者 此 前 不 了 解 ITEnumerable/IEnumerator 〈 及 其 泛 型 版 本 ) 这 对 接 
口 ， 不 妨 借 此 机 会 学 习 二 者 的 差异 。IEnumerable 是 可 用 于 欠 代 的 序 

列 ，IEnumerator 则 像 是 序列 的 一 个 游标 。 多 个 IEnumerator 可 以 壳 历 同 
一 个 IEnumerable， 并 且 不 会 改变 IEnumerable 的 状态 ， 而 IEnumerator 本 
身 就 是 多 状态 的 : 每 次 调用 MoveNext()， 当 前 游标 都 会 向 前 移动 一 个 元 


妨 、\ 9 


如 果 还 不 太 清 楚 ， 可 以 把 IEnumerable 想 象 成 一 本 书 ， 把 IEnumerator 想 
象 成 书签 。 一 本 书 可 以 同时 有 多 个 书签 ， 一 个 书签 的 移动 不 会 改变 书 和 
其 他 书签 的 状态 ， 但 是 书签 自身 的 状态 〈 它 在 书 中 的 位 置 ) 会 改 

变 。 IEnumerable.GetEnumerator() 方 法 如 同一 个 启动 过 程 ， 它 请 求 序列 
就 像 把 一 个 书签 插入 到 一 本 书 的 起 

口 人 。 


有 了 IEnumerator， 就 可 以 重复 调用 MoveNext() 方 法 了 。 如 果 该 方法 返回 
true， 表 示 当 前 游标 移动 到 了 一 个 可 以 通过 current 属 性 来 访问 的 元 
素 ; 如 果 返 回 false， 则 表示 到 达 了 序列 的 末尾 。 


上 述 行为 与 延迟 执行 有 何 关 系 呢 ? 既然 知道 了 使 用 迭代 器 的 代码 要 调用 
什么 方法 ， 下 面 看 看 方法 内 部 何 时 开始 执行 。 以 下 代码 取 自 代码 清单 2- 
11: 














static IEnumerable<int> CreateSimpleIterator() 


{ 
yield return 10; 
for (int i = 0; i < 3; i++) 
yield return 工 ; 
} 
yield return 20; 
} 


当 createsimpleIterator() 被 调用 时 ， 方 法 体 中 的 代码 都 没有 执行 。 


如 果 在 yield return 19 这 一 行 插入 断 点 后 开始 调试 ， 就 会 发 现 方法 被 调 
用 之 后 根本 不 会 触发 断 点 。 调用 GetEnumerator() 方 法 同样 不 会 触发 断 


点 。 只 有 MoveNext() 被 调用 时 方法 才 会 真正 开始 执行 。 然 后 怎么 样 呢 ? 
2.4.3 ”执行 yield 语 名 


I 
人 





。 抛 出 异常 ; 

。 方法 执行 完毕 ; 

。 人 过 到 yield break 语 句 ; 

e 执行 到 yield return 语 句 ， 和 迭代 器 准 备 返 回 值 。 


如 果 抛 出 异常 ， 那 么 该 异常 会 正名 流转 : 如 果 执 行 到 了 方法 末尾 ， 或 者 
过 到 了 yield break 语 句 ，MoveNext() 方 法 就 会 返回 false 来 表示 已 经 到 
达 序 列 的 末尾 : 如果 遇 到 了 yield return 语 句 ，current 属 性 会 被 赋 以 当 
前 欠 代 值 ， 然 后 MoveNext() 返 回 true。 


说 明 ”这 里 需要 洪 清 一 下 ， 前 面 说 异常 正常 流转 的 前 提 是 达 代 器 的 
代码 已 经 在 执行 了 。 请 牢记 ， 直 到 调用 代码 开始 达 代 序列 之 后 ， 达 
代 器 的 代码 才 开 始 执 行 。 抛 出 异常 的 是 MoveNext() 调 用 ， 而 不 是 最 
初 的 达 代 右 方 法 调用 。 


在 本 例 中 ，MoveNext() 开 始 迭 代 之 后 ， 它 过 到 一 条 yield return 106 语 
句 ， 于 是 current 赋 值 为 10， 然 后 返回 true。 


第 一 次 MoveNext() 调 用 还 比较 好 理解 ， 之 后 呢 ? 之 后 不 可 能 从 头 开 始 返 
代 ， 否 则 这 个 函数 就 陷入 无 限 返 回 10 的 死 循环 了 。 实 际 上 ， 

当 MoveNext () 返 回 时 ， 当 前 方法 承 仿 佛 被 暂停 了 。 生 成 的 代码 会 退 踪 当 
前 的 语句 执行 进度 ， 还 会 记录 一 些 相 关 状 态 信息 ， 比 如 循环 中 局 部 变量 
i 的 值 。 当 MoveNext() 再 次 被 调用 ， 束 会 从 之 前 的 位 置 继 续 执行 ， 这 束 
I 
容 站 


2.4.4 延迟 执行 的 重要 性 


接 下 来 借用 一 段 打印 斐 波 那 契 数列 的 代码 来 展示 延迟 执行 的 重要 性 。 下 
面 的 Fibonacci() 方 法 将 返回 一 个 无 限 长 度 的 序列 ， 然 后 由 另外 一 个 方 

















法 友 代 该 数列 ， 直 至 到 达 茶 个 预先 设 定 的 上 限 值 《1000) 。 
代码 清单 2-13 ”迭代 斐 波 那 契 数列 
static IEnumerable<int> Fibonacci() 


int current = 0; 
int next = 1; 








while (true) <------ 只 有 无 限 次 请 求 时 才 会 变 成 无 限 循 环 
{ 
yield return current; <------ 生成 当前 的 斐 波 那 契 值 


int oldCurrent = current 
current = next,; 
next = next + oldCurrent,; 





} 
} 
static void Main() 
foreach (var value in Fibonacci()) <------ 调用 方法 获取 序列 
Console.writeLine(value); <------ 打印 当前 值 
if (value > 1000) <------ break 条 件 
break 
} 
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如 果 不 使 用 和 欠 代 器 ， 该 如 何 实现 这 个 方法 昵 ? 可 以 创建 一 

个 List<int>， 然 后 同 该 列表 添加 值 ， 直 到 达到 预 设 的 上 限 值 。 然 而 ， 
如 果 这 个 上 限 值 很 大 ， 那 么 相应 的 列表 也 会 变 得 很 大 。 而 且 当前 方法 应 
该 只 负 贡 和 韭 波 那 契 数 列 本 映 相 关 的 信息 ， 根 本 就 不 应 该 关心 何 时 停止 
这 样 的 外 部 信息 。 有 时 需要 根据 打印 时 长 来 确定 停止 时 机 ， 有 时 需要 根 
据 打印 的 数目 来 确定 停止 时 机 ， 有 时 则 需要 根据 当前 值 来 确定 停止 时 
机 。 总 不 能 因为 停止 时 机 不 同 ， 而 去 实现 3 个 近似 的 方法 。 


另外 ， 可 以 在 循环 中 就 完成 打印 工作 ， 从 而 可 以 避免 创建 列表 。 但 是 如 
果 这 样 做 ，Fibonacci() 方 法 就 与 元 素 的 使 用 方式 耦合 得 更 紧密 了 。 假 
人 而 是 要 把 它们 相 加 呢 ? 难道 再 写 一 个 方法 
吗 ? 这 种 做 法 显然 违背 了 “关注 点 分 离 ” 原 则 。 


终 只 有 迭代 器 方案 才 更 优 : 用 达 代 器 来 表示 一 个 无 限 长 的 序列 ， 仅 此 


























而 已 。 调 用 方 可 以 根据 需要 来 决定 达 代 次 数 9 或 者 自由 地 使 用 这 些 值 。 


9 前 提 古 不 要 超出 int 值 的 最 大 表示 范围 ， 否 则 可 能 会 抛 出 异常 或 者 返回 
一 个 洲 出 之 后 的 超大 负 值 。 具 体 情 况 取 决 于 代码 是 否 做 了 安全 检查 。 


手动 实现 斐 波 那 契 数列 总 体 来 说 比较 容易 : 执行 流程 简单 ， 并 且 只 需 维 
护 不 同调 用 之 间 有 限 的 几 个 状态 (只 有 一 条 yield return 语 句 ) ; 但 是 
当代 码 趋 于 复杂 时 ， 手 动 实现 就 不 那么 明智 了 。 编 译 器 不 仅 会 生成 一 些 
代码 来 跟踪 执行 位 置 ， 并 且 在 处 理 finally 块 的 问题 上 也 十 分 智能 ， 然 
而 这 部 分 内 容 并 不 是 那么 简单 。 








2.4.5 ”处理 finally 块 


C# 为 代码 执行 流程 控制 提供 了 多 种 语法 机 制 。 下 面 着 重 介绍 finally 块 
的 处 理 ， 因 为 这 部 分 内 容 对 于 迭代 器 来 说 十 分 重要 ， 而 且 探 究 起 来 也 很 
有 意思 。 在 实际 工作 中 ， 通 常会 使 用 using 语 句 而 不 是 直接 用 finally 
块 ， 但 是 using 语 名 是 基于 finally 块 实现 的 ， 因 此 二 者 在 行为 上 具有 一 
致 性 。 


代码 清单 2-14 展 示 了 具体 的 执行 流程 ， 代 码 中 的 迭代 器 在 try 块 中 生成 
了 两 个 元 素 ， 并 逐个 打印 到 控制 合 。 后 面 还 会 多 次 使 用 该 方法 。 


代码 清单 2-14 ”一 个 用 于 记录 执行 进度 的 迭代 器 


static IEnumerable<string> Iterator() 











try 

{ 
Console.WriteLine("Before first yield"); 
yield return "first"; 
Console.WriteLine("Between yields"); 
yield return "second"; 
Console.writeLine("After second yield"); 

} 

finally 

{ 


Console.WriteLine("In finally block"); 
} 
在 运行 这 段 代码 之 前 ， 先 预测 一 下 迭代 该 序列 会 输出 什么 结果 。 特 别 是 











当 返 回 first 时 ， 会 输出 In finally block 这 人 句 吗 ? 有 以 下 两 种 思考 方 
Ts 


。 如 果 认 为 在 执行 到 yield return 语 句 时 ， 执 行 就 暂停 了 ， 风 辑 上 讲 
执行 还 停留 在 try 块 中 ， 那 么 就 不 会 执行 到 finally 块 。 
e。 如 果 认 为 当 执 行 到 yield return 时， 代码 实际 上 返回 到 了 
MoveNext() 调 用 ， 感觉 应 该 已 经 退出 了 try 块 ， 那么 就 应 该 正常 执 
行 finally 块 的 代码 。 
这 里 就 不 卖 关 了 于 了 ， 答 案 是 第 一 个 。 这 种 暂停 执行 的 机 制 更 加 有 效 并 且 
符合 我 们 的 直观 预期 。 如 果 try 块 中 每 执行 一 次 yield return 语 句 ， 就 需 
要 执行 一 次 finally 块 ， 而 且 在 执行 完 方法 的 其 他 代码 之 后 ， 还 要 再 执 
行 一 次 finally 块 。 这 种 行为 怎么 看 都 不 太 正 常 。 


下 面 验证 一 下 上 述 绪论。 代码 清单 2-15 负 责 对 该 序列 进行 迭代 并 逐个 打 
印 。 


代码 清单 2-15 ”一 个 简单 的 foreach 循 环 进行 迭代 并 打印 


static void Main() 











foreach (string value in Iterator()) 
Console.writeLine("Received value: {0}", value); 


} 
以 上 代码 的 执行 结果 显示 finally 块 中 的 代码 确实 只 在 最 后 执行 了 一 
次 。 


Before first yield 
Received value: first 
Between yields 
Received value: second 
After second yield 

In finally block 


这 段 代 码 也 证 明了 延迟 执行 的 存在 :Main() 函 数 的 输出 和 Iterator() 方 
法 的 输出 罕 插 出 现 ， 因 为 迭代 器 在 不 集 地 和 暂 集 和 恢复 。 


前 面 的 达 代 器 都 是 将 整个 序列 全 部 进行 迭代 ， 因 此 还 不 算 难 理解 ， 可 是 








如 果 要 求 欠 代 中 途 停止 呢 ? 如 果 从 迭代 堪 获 取 元 素 的 代码 块 只 调用 一 
次 MoveNext() 呢 《比如 只 获取 序列 第 一 个 元 素 这 样 的 需求 ) ? 这 种 情况 
人 而 永远 都 不 会 去 执行 finally 块 
呢 ? 

答案 是 不 会 。 如 果 完 全 手动 编写 调用 IEnumerator<T> 的 方法 ， 然 后 只 调 
用 一 次 MoveNext () 方 法 ， 那 么 最 终 将 不 会 执行 finally 块 。 如 果 采 

用 foreach 和 循环， 在 序列 全 部 友 代 完成 之 前 退出 循环 ， 那 么 将 执 

行 finally 块 。 代 码 清单 2-16 展 示 了 从 迭 代 中 退出 循环 : 当 遇 到 非 nul1 值 
就 立刻 退出 循环 。 这 段 代 码 与 代码 清单 2-15 的 不 同 之 处 已 加 粗 。 


代码 清单 2-16 ”使 用 友 代 大 退 出 foreach 循 环 


static void Main() 











foreach (string value in Iterator()) 


Console.writeLine("Received value: {0}", value); 
If (value != null) 


break; 


} 
} 


执行 结果 如 下 : 


Before first yield 
Received value: first 
In finally block 


重点 关注 最 后 一 行 结果 : 执行 了 finally 块 。 当 退出 foreach 循 环 

时 ，finally 块 自动 执行 ， 这 是 因为 foreach 循 环 中 隐 含 了 一 条 using 语 
句 。 代 码 清单 2-17 展 示 了 如 何 把 代码 清单 2-16 中 的 foreach 循 环 手 动 改写 
成 等 价 的 代码 。 这 段 代 码 跟 代码 清单 2-12 类 似 ， 只 不 过 这 里 需要 重点 关 
注 using 语 句 。 


代码 清单 2-17 ”将 代码 清单 2-16 扩 展 成 不 使 用 foreach 循 环 的 形式 


static void Main() 





IEnumerable<string> enumerable = Iterator(); 


using (IEnumerator<string> enumerator = enumerable.GetEnumera 
while (enumerator.MoveNext()) 


string value = enumerator.Current; 
Console.writeLine("Received value: {0}", value); 
if (value != null) 


break; 


} 


using 语 句 是 重点 。 它 保证 了 不 管 采 用 何 种 方式 离开 循环 ， 都 会 调 

用 IEnumerator<string> 的 Dispose 方 法 。 在 调用 Dispose 方 法 时 ， 如 果 此 
时 迭代 器 还 暂停 在 try 块 中 也 没有 关系 ，Dispose 方 法 会 负 贡 最 终 调 

用 finally 块 ， 很 智能 吧 ! 


2.4.6 ”处 理 finally 的 重要 性 


昌 然 finally 块 的 处 理 属于 比较 细 术 末节 的 内 容 ， 但 它 对 于 友人 代 大 的 实 
用 性 而 言 意义 重大 。 这 意味 着 友 代 圳 可 以 用 于 那些 需要 杰 放 资源 的 方 
法 ， 比 如 文件 处 理 器 ， 它 还 意味 者 相同 目的 的 迭代 器 可 以 链接 起 来 使 
用 。 第 3 章 将 谈 到 LINQ to Objects 需 要 频 凤 使 用 序列 ， 对 于 文件 或 者 其 
他 资源 的 操作 来 说 ， 可 靠 的 资源 释放 机 制 公关 重 要 。 


这 些 都 要 求 调用 方 释放 迭代 喜 


在 迭代 完 序列 最 后 一 个 元 素 之 前 ， 如 果 不 调 用 迭代 器 的 Dispose 方 
法 ， 就 会 发 生 资源 泄漏 或 者 内 存 清 理 延 迟 ， 因 此 应 当 避 免 这 种 情 
况 。 


虽然 非 泛 型 的 IEnumerator 接 口 并 非 扩 展 自 IDisposable 接 口 ， 

但 foreach 循 环 会 负责 检查 运行 时 实现 是 否 实现 了 IDisposable 接 
口 ， 然 后 根据 需要 调用 Dispose 方 法 。 泛 型 版 的 IEnumerator<T> 由 于 
本 有 身 就 是 扩展 自 IDisposable 接 口 ， 因 此 比 泛 型 的 要 简单 。 


如 果 是 手动 调用 MoveNext() 来 进行 迭代 (肯定 会 有 这 样 的 需求 〉， 
也 需要 手动 调用 Dispose 方 法 。 如 果 是 迭代 泛 型 的 IEnumerable<T>， 


























如 前 所 示 使 用 using 语 句 即 可 ;而 如 果 要 迭代 非 泛 型 序列 ， 那 就 需 
要 像 编 译 器 处 理 foreach 那 样 自行 检查 接口 了 。 


代码 清单 2-18 展 示 了 如 何 从 一 个 文件 中 读 取 并 逐 行 返回 文件 内 容 ， 这 个 
例子 很 好 地 展示 了 达 代 器 块 在 获取 资源 上 的 便捷 性 。 


代码 清单 2-18 逐 行 读 取 文 件 内 容 


static IEnumerable<string> ReadLines(string path ) 





using (TextReader reader = File.OpenText(path)) 
{ 


string line; 
while ((line = reader,ReadLine()) != null) 


yield return line; 


} 
上 


.NET 4.0 引 入 了 File,.ReadLines 方 法 〈 功 能 与 上 述 方法 类 似 ) ， 但 
framework 中 的 这 个 方法 并 不 好 用 。 如 果 调 用 一 次 ReadLines 方 法 并 多 次 
欠 代 结果 ， 实 际 上 只 对 文件 执行 了 一 次 打开 操作 ， 代 码 清单 2-18 则 可 以 
保证 每 次 迭代 都 会 打开 一 次 文件 。 这 种 方式 更 容易 理解 ， 但 也 有 缺陷 : 
如 果 由 于 文件 不 存在 或 者 不 可 读 等 原因 引发 了 异常 ， 将 无 法 及 时 抛 出 异 
常 。 在 设计 API 时 经 常 需要 做 一 些 艰难 的 权衡 。 


这 个 例子 的 重点 在 于 展示 了 友人 代 露 能 够 正确 执行 处 理 的 重要 性 。 如 果 由 
于 foreach 扫 出 异 第 或 者 提前 退出 而 导致 打开 的 文件 未 关闭 ， 这 个 方法 
束 基 本 上 电 无 价值 了。 接 下 来 一 完 达 代 器 背后 的 实现 机 制 。 


2.4.7 ”迭代 器 实现 机 制 概览 


我 认为 在 学 习 代 码 时 很 有 必要 大 致 了 解 一 下 编译 器 的 行为 ， 尤 其 是 某 些 
比较 复杂 的 场景 ， 比 如 迭代 器 、async/await 以 及 匿名 方法 等 。 这 里 仪 为 
抛砖引玉 ， 更 多 细节 ， 请 参考 http:/csharpin-depth.com/ 上 的 一 篇 文章 。 
当然 ，C# 的 官方 实现 规范 永远 更 准确 、 更 详细 。 不 同 的 编译 器 在 实现 细 
节 上 会 略 有 差异 ， 但 大 部 分 编译 占 的 基本 策略 是 一 致 的。 


首先 声明 : 虽然 只 是 实现 一 个 达 代 器 方法 10， 但 编译 器 背后 会 生成 一 个 














全 新 的 类 型 来 实现 相关 接口 。 我 们 所 编写 的 方法 体会 被 移动 到 生成 类 型 
的 MoveNext () 方 法 中 ， 并 且 调 整 相 关 的 执行 语义 。 对 于 以 下 方法 ， 编 译 
器 会 生成 怎样 的 代码 呢 ? 


10 属 性 访问 费 也 可 以 用 迭代 器 实现 ， 不 过 简单 起 见 ， 这 里 仅 讨 论 先 代 器 
的 实现 方法 。 属 性 访问 器 的 实现 方法 与 之 相同 。 


代码 清单 2-19 ” 待 反 编译 的 达 代 器 示例 


public static IEnumerable<int> GenerateIntegers(int count) 





try 
for (int i = 0; i < count i++) 


Console.writeLine("Yielding {0}", 1); 

yield return 工 ; 

int doubled = i * 2) 
Console.writeLine("Yielding {0}", doubled); 
yield return doubled; 


} 


} 
finally 
{ 
Console.writeLine("In finally block"); 


} 


代码 清单 2-19 是 一 个 达 代 器 方 法 的 原始 形式 。 昌 然 只 是 一 个 简单 的 方 
法 ， 但 其 中 隐 含 了 以 下 5 点 精心 设计 : 


一 个 参数 ; 

一 个 需要 在 yield return 语 句 之 间 保 留 的 局 部 变量 ; 
一 个 不 需要 在 yield return 语 句 之 间 保 留 的 局 部 变量 ; 
两 条 yield return 语 句 ; 

一 个 finally 块 。 


上 述 方法 迭代 循环 count 次 ， 每 次 迭代 都 会 生成 两 个 整 型 值 : 和 ix2。 
比如 在 传 入 参数 是 5 的 情况 下 ， 返 回 值 序列 是 0, 0, 1, 2, 2, 4, 3, 6, 4, 8。 


随 书 代码 中 包含 完整 的 反 编 译 代码 ， 并 且 经 过 手动 调整 。 由 于 代码 太 
长 ， 书 中 束 不 全 部 展示 了 ， 这 里 只 做 概述 。 代 码 清单 2-20 给 出 了 代码 的 


主体 结构 ， 但 缺少 具体 的 实现 细节 。 下 面 先 解释 MoveNext () 方 法 ， 该 方 
法 包含 了 实际 工作 的 大 部 分 内 容 。 


代码 清单 2-20 编译 絮 为 碗 代 器 生成 的 代码 结构 


public static IEnumerable<int> GenerateIntegers( (本 行 及 以 下 2 行 ) 上 
int count) 





{ 
GeneratedClass ret = new GeneratedClass(-2); 
ret.count = count; 
return ret; 

} 





private class GeneratedClass (本 行 及 以 下 i1 行 ) 表示 状态 机 的 生成 类 
IEnumerable<int>, IEnumerator<int> 
{ 





public int count; (本 行 及 以 下 4 行 ) 状态 机 中 所 有 不 同 功能 的 字段 
private int State 

private int current; 

private int initialThreadId; 

private int i; 








public GeneratedClass(int state) <------ 桩 方法 和 GetEnumerator: 
{ 


this.state = state,; 
initialThreadId = Environment.CurrentManagedThreadId; 


} 
public bool MoveNext() { ... } <------ 状态 机 的 主体 代码 
public IEnumerator<int> GetEnumerator() { ... } <------ 根据 需 


public void Reset() 


throw new NotSupportedException(); <------ 生成 的 迭代 器 不 文 = 
} 


public void Dispose() { ... } <------ 根据 需要 执行 fijnally 块 





public int Current { get { return current; } } <------ 用 于 返 臣 
private void Finally1() { ... } <------ 在 MoveNext 和 Dispose 方 江 
IEnumerator Enumerable().GetEnumerator() (本 行 及 以 5 行 ) 显 式 实现 


return GetEnumerator(); 


} 


object IEnumerator.Current { get { return current; } } 


以 上 就 是 生成 代码 的 简化 版 本 。 重 点 关注 : 编译 圳 生成 了 一 个 状态 机 ， 
它 古 一 个 私有 的 租 套 类 。 编 译 占 生成 的 代码 中 ， 很 多 变量 名 不 是 合法 的 
C# 标 识 符 ， 人 简便 起 见 ， 我 把 它们 都 改 成 了 C# 的 合法 名 称 。 编 译 占 还 会 
生成 一 个 和 原始 方法 签名 相同 的 方法 ， 调 用 方 会 调用 这 个 新 方法 。 新 方 
法 所 做 的 工作 包括 : 创建 一 个 状态 机 实例 、 复 制 参 数 、 把 状态 机 返回 给 
EE Se 





状态 机 中 包含 了 实现 碗 代 右 的 全 部 内 容 。 


。 方法 当前 执行 位 置 指示 器 。 该 指示 右 与 CPU 的 指令 计数 器 类 似 ， 但 
更 简单 ， 因 为 只 需要 区 分 大 干 种 状态 。 

。 所 有 参数 的 一 份 复 本 ， 当 需要 使 用 参数 值 时 方便 获取 。 

。 方法 体 中 定义 的 局 部 变量 。 

。 最 近 一 次 生成 的 值 。 调 用 方 可 以 通过 current 属 性 获取 该 值 。 


之 后 调用 方 会 执行 以 下 操作 。 





(1) 调用 GetEnumerator() 来 获得 ITEnumerator<int>。 


(2) 反复 调用 MoveNext () 并 访问 IEnumerator<int> 中 的 Current 属 性 ， 直 
到 MoveNext() 返 回 false。 


(3) 在 需要 清理 内 存 时 调用 Dispose 方 法 ， 无 论 是 否 有 异常 抛 出 。 


绝 大 部 分 情况 下 ， 状 态 机 只 能 在 创建 它 的 线程 内 被 使 用 一 次 。 编 译 嚣 生 
成 这 样 的 代码 旨 在 优化 下 列 情 形 : GetEnumerator() 方 法 负责 检查 状态 

机 ， 比 如 状态 机 处 于 当前 线程 且 为 初始 态 ， 则 返回 this， 因 此 状态 机 需 
要 同时 实现 IEnumerable<int> 和 IEnumerator<int> 这 两 个 接口 。 通 常 代 

码 中 很 少 需 要 同时 实现 这 两 个 接口 11。 如 果 GetEnumerator() 被 其 他 线程 
调用 或 多 次 被 调用 ， 这 些 调用 会 各 目 创 建 一 个 新 的 状态 机 实例 ， 并 复制 
初始 的 参数 值 。 


11 如 果 原 方法 只 返回 IEnumerator， 状 态 机 就 只 需要 实现 IEnumerator 这 














= ls 


MoveNext() 方 法 的 内 容 比较 复杂 。 它 第 一 次 被 调用 时 ， 会 正常 执行 其 中 
的 代码 ;， 在 后 续 调 用 中 ， 它 就 需要 准确 跳 转 到 方法 中 的 指定 位 置 。 本 地 
0 
在 一 个 优化 过 的 构建 中 ， 有 些 局 部 变量 是 不 需要 复制 给 字段 的 。 使 用 字 
段 来 保存 局 部 变量 的 好 处 是 ， 当 下 一 个 MoveNext() 到 来 时 可 以 奶 踪 前 一 
个 MoveNext () 调 用 的 局 部 变量 值 。 注 意 ， 代 码 清单 2-19 中 doubled 这 个 局 
部 变量 是 个 例外 : 


for (int i = 0; i < count; i++) 























{ 
Console.writeLine("Yielding {0}", 1); 
yield return 工 ; 
int doubled = i * 2; 
Console.writeLine("Yielding {0}", doubled); 
yield return doubled; 

} 


对 于 doubled 变 量 只 是 做 了 初始 化 、 打 印 值 ， 最 后 生成 值 。 当 再 次 返回 
到 方法 时 ，doubled 变 量 已 经 没 用 了 ， 因 此 编译 器 在 做 发 布 构建 时 ， 会 
把 它 优 化 成 真正 的 局 部 变量 ， 但 是 在 调试 构建 中 为 方便 调试 ， 还 会 保留 
该 变量 。 注 意 ， 如 果 把 最 后 两 行 加 粗 的 代码 调换 顺序 一 一 先生 成 再 打 
印 ， 编 译 融 就 不 能 进行 上 述 优 化 了 。 


MoveNext () 方 法 内 部 是 如 何 实现 的 呢 ? 这 里 不 会 给 出 具体 的 代码 ， 人 否则 
容易 深 陷 于 纷 坚 的 细 市 中 ， 因 而 只 给 出 大 致 结构 。 


代码 清单 2-21 简化 版 的 MoveNext() 方 法 


public bool MoveNext() 



































try 
switch (state) 
<------ 跳 转 表 负责 跳 转 到 方法 中 的 正确 位 置 
i 方法 代码 在 每 个 yeild return 都 会 返回 





fault <------ 只 有 发 生 异 常 时 fault 块 的 代码 才 会 执行 


Dispose(); <------ 发 生 异 常 后 清理 资源 
































状态 机 包含 了 一 个 变量 (state) 用 于 记录 当前 执行 位 置 。 变 量 的 具体 
值 随 不 同 的 实现 有 所 差别 。 以 Roslyn 编 译 器 为 例 ， 状 态 值 如 下 所 示 。 


e。 -3: MoveNext() 当 前 正在 执行 。 

。 -2: GetEnumerator() 尚 未 被 调用 。 

e。 -1: 执行 完成 (无 论 成 功 与 否 ) 。 

e。 0: GetEnumerator() 已 被 调用 ， 但 是 MoveNext() 还 未 被 调用 (方法 
的 开始 ) 。 

e。 1: 在 第 1 条 yield return 语 句 。 

。2: 在 第 2 条 yield return 语 句 。 


当 调 用 MoveNext() 时 ， 它 利用 上 述 状态 在 方法 的 执行 位 置 进行 跳 转 ， 跳 
转 到 执行 初始 位 置 或 者 恢复 到 上 一 条 yield return 语 句 的 位 置 。 请 注 
意 ， 代 码 中 不 存在 表示 “为 doubled 变 量 赋值 ”位 置 的 状态 ， 因 为 没有 从 
该 位 置 恢复 执行 的 需要 ， 只 需要 从 上 次 暂停 的 位 置 恢复 执行 即 可 。 


代码 清单 2-21 中 靠近 结尾 的 fault 块 是 一 个 I 开 结 构 ， 该 结构 在 C# 中 并 没 
有 对 等 形式 。 它 类 似 于 finally 块 ， 在 发 生 异 常 时 会 被 执行 ， 但 并 不 捕 
获 异 常 。〔 为 什么 finally 块 在 异常 发 生 时 才 执 行 呢 ?) 这 用 于 根据 需 
要 执行 清理 操作 ， 在 本 例 中 等 同 于 finally 块 中 的 内 容 。finally 块 中 的 
代码 被 移动 到 了 一 个 单独 的 方法 中 ， 然 后 由 Dispose( ) 来 调用 (发 生 异 
和 常 时 ) 或 者 由 MoveNext() 调 用 (正常 执行 完 try 块 中 的 逻 

辑 ) 。Dispose() 方 法 会 依据 当前 状态 来 确定 需要 执行 何 种 清理 操 

作 。finally 块 越 多 ， 此 处 逻辑 就 越 复 杂 。 


探究 特性 背后 的 实现 机 理 ， 虽 然 无 法 直接 提升 C# 编 程 技能 ， 但 是 至 少 让 
我 们 了 解 了 编译 器 背后 所 做 的 大 量 工 作 。 类 似 的 机 制 在 C# 5 中 的 
async/await 也 有 应 用 ， 只 不 过 在 异步 过 程 中 ， 恢 复 执 行 的 操作 不 是 

由 MoveNext() 调 用 触发 ， 而 是 由 异步 操作 的 完成 来 触发 。 


至 此 ，C# 2 中 最 庞大 的 一 个 特性 就 介绍 完毕 了 。C# 2 还 引入 了 一 些 不 太 
复杂 的 小 特性 ， 下 面 集中 介绍 。 这 些小 特性 之 间 没 有 太 多 相关 性 ， 不 过 
有 时 这 也 是 语言 设计 工作 的 一 部 分 。 



































2.5 一 些小 的 特性 


下 面 要 介绍 的 部 分 特性 我 个 人 很 少 用 到 ， 但 还 有 一 些 特性 在 现代 C# 代 码 
库 中 十 分 常见 。 特 性 的 使 用 频 度 和 介绍 它 所 用 的 篇 幅 并 不 一 定 成 正比 。 
本 将 介绍 以 下 特性 。 


局 部 类 型 : 单个 类 型 的 代码 可 以 分 散在 多 个 源 文件 中 。 

用 于 工具 类 型 的 静态 类 。 

属性 get 访 问 器 和 set 访 问 器 的 访问 性 分 离 (public、private 等 ) 。 
改进 命名 空间 别名 : 简化 在 多 个 命名 空间 或 程序 集中 同名 的 使 用 。 
4 
等 功能 。 

。 大 小 固定 的 绥 冲 区 : 用 于 非 安全 代码 中 的 数据 内 联 。 

e [InternalsvVisibleTo] 特 性 : 简化 测试 环节 。 


以 上 特性 都 相互 独立 ， 因 此 讨论 顺序 无 关 紧 要 ， 而 且 如 果 读 者 对 某 一 特 
性 不 感 兴趣 ， 可 以 选择 略 过 ， 不 会 影响 理解 后 面 内 容 的 学 习 。 
2.5.1 局 部 类 型 


局 部 类 型 允许 单个 类 、 结 构 体 或 者 接口 分 成 多 个 部 分 声明 ， 而 且 一 般 分 
布 于 多 个 源 文 件 。 局 部 类 型 常 与 代码 生成 费 配 合 使 用 ， 多 个 代码 生成 右 
分 别 锋 责 不 同 的 声明 部 分 ， 之 后 还 可 以 通过 手动 编码 予以 强化 。 编 译 絮 
会 整合 这 些 部 分 ， 这 样 局 部 类 型 的 行为 就 与 非 局 部 类 型 一 致 了 。 

在 声明 局 部 类 型 时 ， 需 要 在 类 型 声明 前 添加 partial 修 饰 符 ， 并 且 每 个 
声明 部 分 都 需要 partial 修 饰 。 代 码 清单 2-22 是 由 两 部 分 组 成 的 一 个 类 声 
明 ， 展 示 了 在 一 个 部 分 中 声明 的 方法 可 以 在 另外 一 个 部 分 中 正常 调用 。 
代码 清单 2-22 ”一 个 局 部 类 的 简单 示例 


partial class PartialDemo 























public static void MethodInPart1() 








MethodInPart2(); <------ 调用 在 第 2 部 分 声明 的 方法 


partial class PartialDemo 





private static void MethodInPart2() <------ 被 第 1 部 分 调用 的 方法 
Console.writeLine("In MethodIinpPart2"); 


} 


此 外 ， 如 果 声 明 的 是 泛 型 类 型 ， 那 么 其 各 部 分 声明 的 类 型 名 和 类 型 形 参 
都 必须 相同 。 如 果 存 在 类 型 约束 ， 那 么 这 些 类 型 约束 也 必须 相同 。 如 采 
声明 的 类 型 实现 了 多 个 接口 ， 那 么 这 些 局 部 类 型 可 以 负责 各 目的 接口 实 
现 ， 而 且 实 现 部 分 和 相应 接口 可 以 不 在 同一 声明 中 。 


局 部 方法 (C# 3) 


C# 3 还 引入 了 局 部 类 型 的 一 个 扩展 特性 : 局 部 方法 。 编 写 局 部 方法 ， 可 
以 在 一 个 类 型 的 局 部 声明 中 声明 一 个 不 包含 方法 体 的 方法 ， 而 在 男 一 个 
局 部 声明 中 定义 该 方法 的 实现 (可 选 )。 局 部 方法 默认 是 私有 方法 ， 返 
回 值 必须 是 void 且 不 能 使 用 out 参 数 〈 可 以 使 用 ref 参 数 ) 。 在 编译 时 ， 

只 会 保留 实现 了 的 局 部 方法 。 如 果 局 部 方法 只 是 声明 而 没有 实现 ， 那 么 
会 移 除 该 方法 的 所 有 调用 代码 。 这 种 策略 乍 看 有 些 奇 怪 ， 但 很 有 用 : 可 
以 由 生成 堪 来 负责 生成 可 选 的 “钩子 方法 ”， 之 后 就 可 以 手动 为 “钩子 方 

法 ”添加 额外 的 行为 了 。 代 码 清单 2-23 定 义 了 两 个 局 部 方法 ， 其 中 一 个 

已 实现 > 一 个 未 实现 3 


代码 清单 2-23 ”两 个 局 部 方法 一 一 一 个 已 实现 ， 一 个 未 实现 


partial class PartialMethodsDemo 

















public PartialMethodsDemo() 
{ 





OnConstruction(); <------ 调用 尚未 实现 的 局 部 方法 

} 

public override string ToString() 

{ 
string ret = "Original return value"; 
CustomizeToString(ref ret); <------ 调用 已 经 实现 的 局 部 方法 





return ret; 








partial void Onconstruction(); (本 行 及 以 下 1 行 ) 局 部 方法 声明 
partial void CustomizeToString(ref string text); 


} 
partial class PartialMethodsDemo 
partial void CustomizeToString(ref string text) <------ 局 部 方 

text += " - customized!"; 

} 

以 上 代码 中 ， 第 1 部 分 很 可 能 是 由 生成 带 目 动 生 成 的 ， 在 构 迁 和 获取 字 

符 串 表示 时 可 以 有 额外 的 行为 ， 第 2 部 分 属于 手动 编写 的 代码 ， 它 不 允 

许 对 构建 进行 定制 操作 ， 但 会 改变 Tostring() 方 法 返回 的 字符 串 表 示 。 


虽然 customizeTostring 没 有 直接 返回 定制 的 值 ， 但 是 可 以 通过 ref 参 数 
修改 传 入 值 来 达到 相同 的 效果 。 


由 于 onconstruction 方 法 只 有 声 明 没 有 实现 ， 因此 编译 器 会 将 它 彻 底 移 
除 。 像 这 种 只 有 声明 没有 实现 的 局 部 方法 ， 如 果 它 具有 参数 并 且 被 调 
用 ， 那 么 调用 中 的 实 参 表 达 式 也 不 会 被 执行 。 


强烈 建议 把 代码 生成 上 器 设计 成 可 以 生成 局 部 类 。 哪 怕 纯 手写 代码 ， 也 不 


要 忽视 局 部 类 的 作用 。 我 曾 使 用 局 部 类 把 某 些 大 型 类 对 应 的 测试 代码 分 
散 到 多 个 源 文 件 中 ， 这 样 便于 管理 和 组 织 文 件 。 


2.5.2 ”静态 类 


静态 类 是 指使 用 static 修 饰 符 修饰 的 类 。 如 果 要 编写 一 个 全 部 由 静态 方 
法 组 成 的 工具 类 ， 静 态 类 是 不 二 之 选 。 静 态 类 内 部 不 能 声明 实例 方法 、 
属性 、 事 件 或 构造 器 ， 但 是 可 以 声明 普通 的 符 套 类 。 

虽然 声明 一 个 仅 包含 静态 成 员 的 非 静态 类 是 完全 合法 的 ， 不 过 为 了 表明 
该 类 的 用 途 ， 最 好 在 前 面 加 上 static 修 饰 符 。 因 为 编译 器 知道 静态 类 不 
能 实例 化 ， 所 以 它 可 以 防止 静态 类 用 作 变 量 类 型 或 是 类 型 实 参 。 代 码 清 
单 -24 展 示 了 静态 类 的 使 用 规则 。 

代码 清单 2-24 静态 类 示例 


static class StaticClassDemo 









































public static void StaticMethod() { } <------ 合法 : 静态 类 可 以 声 














public void InstanceMethod() { } <------ 非法 : 




























































































public class RegularNestedClass <------ 合法 : 静态 类 可 Lb 普通 匠 
public void InstanceMethod() { } <------ 合法 : 
staticClassDemo .StaticMethod()， 二 合法 : 二 
StaticCclassDemo localVariable = null; <------ 非法 : 不 外 


List<StaticClassDemo> list 
new List<StaticClassDemo>(); 























(本 行 及 以 下 1 行 ) 非法: 不 能 将 静态 类 用 作 类 于 














此 外 ， 扩 展 方法 (于 C#3 引 入) 对 于 静态 类 也 有 特殊 要 求 : 扩展 方法 只 





能 在 非 退 套 、 非 泛 型 的 静态 类 中 声明 。 


2.5.3 ”属性 的 getter/setter 访 问 分 离 


很 难 想象 C# 1 中 属性 居然 只 有 单一 的 访问 修饰 符 ， 这 个 修饰 符 必须 同时 
作用 于 getter 访 问 器 和 setter 访 问 器 。C#2 则 引入 了 新 机 制 : 可 以 通过 添 
加 修饰 符 来 让 一 个 访问 器 比 另 一 个 更 私有 。 通 常 都 是 让 setter 访 问 器 比 
getter 访 问 器 更 私有 。 最 常见 的 组 合 是 public getter 搭 配 private 


setter: 


private string text; 
public string Text 


get { return text; } 
private set { text = value; } 


} 





本 例 中 ， 只 要 拥有 text 属 性 setter 的 访问 权限 ， 就 可 以 直接 为 字段 赋值 。 








但 是 对 于 更 为 复杂 的 场景 ， 
变化 时 的 通知 功能 。 








可 能 还 需要 增加 校 验 功 能 或 者 增加 字段 及 生 
使 用 属性 可 以 很 好 地 把 这 些 行为 封装 起 来 。 当 然 ， 





也 可 以 通过 编写 一 个 方法 来 实现 相同 的 功能 ， 但 是 用 属性 来 实现 更 符合 


C# 的 编码 传统 。 
命名 空间 别名 


2.5.4 





命名 空间 的 作用 是 允许 在 不 同 的 命名 空间 下 定义 多 个 同名 类 型 。 使 用 命 


名 空间 ， 可 以 避免 为 保证 命名 唯一 而 导致 的 见长 类 型 名 。C# 1 已 经 支持 
了 命名 空间 和 命名 空间 别名 这 两 个 特性 。 这 样 一 来 ， 当 需要 在 同一 源码 
文件 中 使 用 不 同 命 名 空间 下 的 同名 类 型 时 ， 束 可 以 清晰 、 准 确 地 表示 有 具 
体 指 代 哪个 类 型 。 代 码 清单 2-25 展 示 了 如 何在 一 个 方法 内 部 同时 使 用 来 
自 Windows Forms 和 ASP.NET Web Forms 的 两 个 Button 类 。 


代码 清单 2-25”C#1 中 的 命名 空间 别名 
using System; 


using WinForms 
using WebForms 





System.Windows.Forms; (本 行 及 以 下 1 行 ) 引入 命名 空间 另 
System.Web .UI.WebControls; 


class Test 
static void Main() 


Console.writeLine(typeof(WinForms.Button)); (本 行 及 以 下 1 行 
Console.writeLine(typeof (WebForms.Button)); 


} 
C# 2 从 3 个 重要 方面 扩展 了 对 命名 空间 别名 的 支持 。 
1. 命名 空间 别名 限定 符 语法 

对 于 代码 清单 2-25 中 winForms ,Button 这 条 语句 ， 只 要 不 存在 男 外 一 
个 名 为 winForms 的 类 型 就 没有 问题 ， 如 果 存 在 这 样 一 个 类 型 ， 编 译 
器 就 会 把 winForms .Button 看 作 访 问 wWinForms 类 型 的 Button 成 员 ， 而 
不 是 把 winForms 当 作 命 名 空间 别名 来 对 等。 为 了 解决 这 一 问题 ，C# 
2 引入 了 一 种 新 的 语法 命名 空间 别名 限定 符 ， 使 用 一 对 冒号 来 
表示 冒号 前 的 标识 符 是 命名 空间 别名 而 不 是 类 型 名 ， 从 而 避免 下 
义 。 使 用 新 语法 改写 以 上 代码 : 


static void Main() 


























Console.writeLine(typeof (WinForms: :Button)); 
Console.writeLine(typeof (WebForms: :Button)); 


消除 歧义 不 仅 有 助 于 编译 器 的 识别 工作 ， 更 重要 的 是 区 分 了 命名 空 
间 别 名 和 类 型 名 ， 增 强 了 可 读 性 。 建 议 在 使 用 命名 空间 别名 时 ， 统 
一 使 用 双 冒 号 语法 。 











见 ， 但 还 是 有 可 能 发 生 的 。 在 C# 2 之 前 ， 是 无 法 完全 区 分 命名 空间 
下 的 类 型 的 。C# 2 引入 了 global 作 为 全 局 命名 空间 的 一 个 别名 。 该 
别名 除了 可 以 指示 全 局 命名 空间 中 的 类 型 ， 还 可 以 用 于 类 型 完全 限 
定名 的 一 个 “ 根 ” 命 名 空间 (这 也 是 我 最 常用 的 一 个 功能 


例如 最 近 我 在 处 理 很 多 带 DateTime 参 数 的 方法 ， 当 向 当前 命名 空间 
引入 另外 一 个 名 为 DateTime 类 型 的 时 候 ， 这 些 函 数 声 明 就 无 法 正常 
工作 了 。 相 比 为 System 命名 空间 起 一 个 别名 ， 把 每 

个 system.DateTime 的 位 置 都 蔡 换 成 global: :System.DateTime 更 简 
单一 些 。 我 发 现 命 名 空间 别名 《尤其 是 全 局 命名 空间 别名 ) 在 编写 
代码 生成 器 或 者 处 理 上 自动 生成 的 代码 时 非常 有 用 ， 因 为 这 些 地 方 比 
较 容易 发 生命 名 冲突 。 














.外 部 别名 


前 面 讨论 了 不 同 命名 空间 下 相同 类 型 名 的 冲突 问题 ， 现 在 更 进 一 
步 : 假设 有 不 同 的 程序 集 ， 它 们 提供 了 相同 的 命名 空间 ， 而 命名 空 
间 中 又 有 相同 的 类 型 名 ， 这 要 怎么 处 理 呢 ? 


这 绝对 属于 罕见 情况 ， 但 还 是 有 可 能 出 现 。C# 2 引入 了 外 部 别名 来 
处 理 这 种 情况 。 在 源码 中 声明 外 部 别名 时 无 须 指 定 任 何 关联 的 命名 


空间 : 














extern alias FirstAlias; 
extern alias SecondAlias; 


在 同一 源码 中 ， 可 以 在 using 指 令 中 使 用 该 别名 ， 或 者 使 用 类 型 完 
全 限定 名 。 例 如 使 用 Json.NET 期 间 又 添加 了 一 个 声明 了 
Newtonsoft.Json.Linq.J0bject 的 程序 集 ， 那 么 可 以 如 下 所 示 编 写 
代码 : 


extern alias JsonNet,; 
extern alias JsonNetAlternative; 


Using JsonNet::Newtonsoft.Json.Ling; 
using ALtJobject = JsonNetAlternative::Newtonsoft.Json.Linq.J 


JObject obj = new JObject(); <------ 使 用 普通 Json ,NET 对 象 类 型 
AltJobject alt = new AltJObject(); <------ 在 另 一 个 程序 集中 使 用 J 


这 么 写 还 有 一 个 问题 : 需要 把 每 个 外 部 别名 与 对 应 的 程序 集 关 联 起 
来 。 该 关联 机 制 与 具体 实现 相关 ， 例 如 可 以 在 工程 选项 中 指定 ， 也 
可 以 在 编译 命令 行 中 指定 。 

我 不 记得 自己 是 否 使 用 过 外 部 别名 。 我 通常 把 外 部 别名 看 作 一 种 权 
宜 之 计 ， 因 为 在 一 开始 就 可 以 选择 一 些 能 够 避免 命名 冲突 的 其 他 解 
决 方案 。 不 过 有 这 样 一 个 权宜 之 计 可 供 选择 ， 终 归 是 一 件 好 事 。 











2.5.5 ”编译 指令 


编译 指令 是 与 具体 实现 相关 的 指令 ， 这 些 指令 可 以 为 编译 器 提供 额外 的 
信息 。 编 译 指令 并 不 能 改变 程序 的 行为 ， 不 能 违反 C# 语 言 规范 。 除 此 之 
外 ， 编 译 指令 几乎 是 万 能 的 。 编 译 器 会 对 无 法 识别 的 指令 发 出 警告 ， 但 
不 会 生成 错误 信息 。 编 译 器 指令 的 语法 比较 简单 ， 由 #pragma 关 键 字 项 
格 ， 后 面 紧 跟 编译 指令 的 内 容 。 


微软 C# 编 译 虱 文 持 警 告 指令 以 及 校 验 和 指令 。 校 验 和 指令 一 般 出 现在 自 
动 生 成 的 代码 中 ， 和 警告 指令 主要 用 于 共用 和 局 用 特定 的 警告 信息 ， 例 如 
对 一 段 特定 代码 共用 CS0219 和 警告 《变量 已 赋值 ， 但 未 被 使 用 ) : 


#pragma warning disable CS0219 
int variable = CallSomeMethod(); 
#pragma warning restore CS0219 


在 C# 6 之 前 ， 只 能 使 用 数字 来 作为 警告 的 标识 。Roslyn 编 译 器 进一步 提 
升 了 编译 流 的 扩展 性 ， 其 他 被 纳入 构建 的 包 也 可 以 提供 警告 信息 。 为 
此 ，C# 语 言 修改 了 警告 标识 的 规则 ， 人 允许 在 警告 标识 前 添加 前 级 (比如 
C# 编 译 占 的 前 级 是 cs) 。 明 确 起见 ， 建 议 所 有 警告 信息 都 添加 前 级 〈 例 
如 要 写成 CS0219 而 不 是 0219) 。 


如 琳 没 有 指定 警告 标识 符 ， 那 么 所 有 和 警告 信息 都 会 受 影响 。 我 从 未 用 过 
这 个 机 制 ， 也 不 建议 使 用 。 通 常情 况 下 ， 需 要 修正 党 告 信息 而 不 是 茶几 
它们 。 如 果 一 味 地 禁用 警告 信息 ， 只 会 掩盖 代码 中 隐藏 的 问题 。 



































2.5.6 ”固定 大 小 的 缓冲 区 


回 定 大 小 的 缓冲 区 这 项 特性 ， 我 也 从 未 在 产品 代码 中 使 用 过 ， 但 它 依 然 
有 用 ， 尤 其 是 需要 和 本 机 代码 频繁 交互 时 。 

回 定 大 小 的 缓冲 区 只 能 用 于 非 安全 的 代码 ， 并 且 只 能 用 于 结构 体内 部 。 
该 缓冲 区 负责 在 结构 体内 部 分 配 一 块 固定 大 小 的 内 存 ， 在 语法 上 需要 使 
用 fixed 修 饰 符 。 代 码 清单 2-26 展 示 了 一 个 结构 体 ， 其 中 包含 一 个 任意 
16 字 节 的 数据 ， 两 个 32 位 的 整 型 用 于 表示 数据 的 主 版 本 号 和 小 版 本 号 。 
代码 清单 2-26 ”用 固定 大 小 的 缓冲 区 表示 一 个 版 本 化 的 数据 块 


unsafe struct VersionedData 











public int Major; 

public int Minor; 

public fixed byte Data[16]; 
} 


unsafe static void Main() 


VersionedData versioned = new VersionedData( ) ， 
versioned.Major = 2; 

versioned.Minor = 1; 

versioned.Data[10|] = 20; 











以 上 结构 体 类 型 的 大 小 应 该 是 24 字 市 或 者 32 字 节 ， 因 为 运行 时 会 以 8 字 
市 为 单位 对 齐 数 据 。 这 里 的 重点 是 : 所 有 数据 都 直接 存储 在 结构 体内 

部 ， 没 有 指向 外 部 字 节 数组 的 引用 。 该 结构 体 可 以 用 于 和 本 机 代码 的 相 
互 调用 ， 也 可 以 用 于 普通 的 托管 代码 。 


警告 尽管 此 前 给 出 过 关于 使 用 示例 代码 的 一 般 和 警告， 这 里 还 需要 
具体 表述 一 下 : 为 保证 代码 尽量 简短 ， 以 上 结构 体 没 有 进行 任何 封 
装 操 作 。 这 段 代 码 仅 用 于 初步 展示 固定 大 小 缓冲 区 的 语法 。 


C# 7.3 天 于 访问 大 小 固定 组 种 区 字段 的 改进 
代码 清单 2-26 展 示 了 如 何 通过 局 部 变量 访问 固定 大 小 的 缓冲 区 。 假 设 


versioned 变 量 不 是 局 部 变量 ， 而 是 一 个 类 的 字段 ， 在 C# 7.3 之 前 ， 需 要 
通过 fixed 语 句 来 创建 一 个 指针 才能 访问 versioned.Data; 到 了 C# 7.3 以 
































后 ， 就 可 以 通过 字段 直接 访问 该 缓冲 区 了 ， 不 过 仍 限于 非 安全 的 上 下 文 
中 。 


2.5.7 InternalsVisibleTo 


C# 2 的 最 后 一 个 特性 依然 属于 framework 和 运行 时 的 范畴 ， 其 至 C# 语 言 
规范 中 根本 就 没有 介绍 该 特性 ， 不 过 任何 现代 C# 编 译 器 都 不 会 忽略 该 特 
性 。framework 提 供 了 一 个 名 为 [InternalsvisibleToAttribute] 的 程序 
集 级 别 的 attibute， 它 包含 一 个 参数 ， 用 于 指定 另 一 个 程序 集 。 由 该 参 
数 指定 的 程序 集 ， 可 以 访问 当前 程序 集中 包含 该 attibute 的 内 部 成 员 ， 
代码 如 下 所 示 : 


[assembly:InternalsVisibleTo("MyProduct.Test")] 


定好 程序 集 之 后 ， 还 需要 在 程序 集 名 称 中 包含 对 应 的 公 钥 ， 参 考 Noda 
Time 项 目 中 的 写法 : 


[assembly:InternalsVisibleTo("NodaTime.Test,Publickey=0024...4669 


当然 ， 真 正 的 公 钥 要 比 示例 中 的 长 得 多 。 虽 然 以 这 种 方式 来 指定 程序 集 
看 起 来 并 不 怎么 优雅 ， 但 毕竟 写 好 之 后 很 少 需要 再 去 关心 其 内 容 了 。 我 
曾 在 以 下 3 个 场景 中 应 用 过 该 特性 〈 有 一 个 之 后 后 悔 了 了 ) 。 


。 允许 测试 程序 集 访问 内 部 成 员 ， 以 此 简化 测试 工作 。 
。 允许 私有 工具 类 访问 内 部 成 员 ， 以 此 避免 代码 复制 。 
。 允许 茶 个 库 访 问 男 一 个 关系 紧密 的 库 的 内 部 成 员 。 


最 终 证 明 最 后 一 个 场景 并 不 合适 : 我 们 往往 习惯 性 地 认为 内 部 代码 的 修 
改 不 会 影响 程序 的 版 本 号 。 对 于 版 本 号 相互 独立 的 两 个 库 ， 如 果 骏 露 一 
个 库 的 内 部 代码 给 另外 一 个 库 ， 内 部 代码 就 会 像 公 开 代 码 那样 对 版 本 号 
产生 影响 了 。 我 会 时 刻 铭记 以 上 教训 并 以 此 为 戒 。 


对 于 测试 类 和 工具 类 ， 我 青睐 暴露 内 部 代码 的 做 法 。 我 知道 测试 界 有 一 
条 准则 一 一 只 测试 公共 API， 但 是 一 般 而 言 ， 我 们 都 会 尽力 控制 对 外 暴 
圳 的 公共 API 范 围 ， 使 之 最 小 。 因 此 ， 如 果 想 简化 测试 代码 ， 不 妨 多 用 
这 种 方式 来 访问 内 部 成 员 。 





























2.6 ”小结 


e。 C# 2 新 引入 的 各 项 特性 让 C#i 语 言 的 风格 发 生 了 巨大 变化 。 泛 型 和 可 
空 类 型 已 经 是 C# 中 不 可 或 缺 的 成 员 了 。 

使 用 泛 型 ，API 签 名 可 以 更 好 地 表达 类 和 方法 的 类 型 信息 。 泛 型 提 
升 了 编译 时 的 类 型 安全 ， 同 时 没有 增加 代码 见 余 。 

引用 类 型 一 直 以 来 都 具备 表达 信息 缺失 的 能 力 。 可 空 值 类 型 让 值 类 
型 也 获得 了 相应 的 语言 、 运 行 时 和 framework 的 支持 ， 从 此 使 用 起 

来 更 便捷 。 

目 C#2 起 委托 变 得 更 易 用 了 。 方 法 组 转换 和 和 匿名 方法 增强 了 语言 
的 功能 、 提 升 了 语言 的 简洁 性 。 

和 友 代 堪 可 以 以 延迟 执行 的 方式 产生 序列 ， 可 以 暂停 方法 的 执行 ， 当 
调用 方 请 求 下 一 个 值 时 再 恢复 执行 。 

不 是 所 有 特性 都 是 重大 特性 ， 诸 如 局 部 类 型 、 静 态 类 这 样 的 小 特性 
依然 可 以 大 有 作为 。 有 些小 特性 应 用 得 不 是 特别 广泛 ， 但 是 对 于 某 
些 特 殊 场 景 来 说 至 关 重 要 。 
































第 3 章 C#3: LINQ 及 相关 特性 


本 章 内 容 概览 


。 如 何 轻松 实现 简单 属性 ; 

。 如 何 更 简洁 地 初始 化 对 象 和 集合 ; 

。 如 何 为 局 部 数据 创建 匿名 类 型 ; 

。 如 何 使 用 lambda 表 达 式 构建 委托 和 表达 式 树 ; 
。 如 何 仅 使 用 查询 表达 式 实 现 复 杂 查 询 。 


C# 2 的 大 部 分 特性 互 无 关联 。 虽 然 可 空 值 类 型 依赖 泛 型 特性 ， 但 二 者 外 
此 独立 ， 因 为 它们 所 服务 的 目标 不 同 。 


C# 3 则 不 同 ， 它 引入 了 大 量 新 特性 ， 这 些 新 特性 在 各 目 领 域 均 有 建树 ， 
但 是 总 体 上 都 服务 于 同一 个 目标 : LINQ。 本 章 将 逐个 介绍 这 些 特性 ， 
人 
I 


3.1 目 动 实现 的 属性 

在 C# 3 之 前 ， 每 个 属性 都 需要 手动 实现 ， 手 动 为 属性 体 添加 get 访 问 器 
或 set 访 问 器 。 编 译 器 能 够 实现 类 字段 的 事件 ， 但 不 能 实现 属性 ， 即 会 
有 很 多 属性 如 下 所 示 : 


private string name; 
public string Name 














get { return name; } 
set { name = value; } 


2 

由 于 编码 风格 存在 差别 ， 具 体 的 属性 会 有 不 同 的 实现 形式 。 不 过 ， 无 论 
是 长 长 的 一 行 还 是 短 短 的 数 行 ， 痢 属于 元 余 代码 。 先 定义 一 个 字段 ， 再 
定义 属性 ， 从 而 对 外 提供 字段 访问 ， 这 种 方式 无 疑 十 分 哆 唆 。 


通过 上 自动 实现 的 属性 简称 自动 属性 ) ，C# 3 大 大 简化 了 这 一 环节 。 有 








了 自动 属性 之 后 ， 将 由 编译 器 负责 实现 原先 的 访问 器 部 分 ， 于 是 前 一 自 
代码 可 以 缩减 为 一 行 : 


public string Name { get; set; } 


字段 的 声明 也 不 再 是 必需 的 了 。 实 际 上 字段 依然 存在 ， 只 不 过 由 编译 絮 
目 动 创 建 并 为 其 赋予 一 个 名 称 ， 这 个 名 称 在 C# 代 码 中 是 不 可 见 的 。 


另外 ， 不 能 在 C# 3 中 声明 只 读 的 自动 属性 ， 而 且 在 声明 时 不 能 赋 初 始 
值 。 不 过 ，C# 6 修复 了 这 两 个 瑕 辛 ， 详 见 8.2 节 。 在 C# 6 之 前 ， 只 能 通过 
将 set 访 问 器 设 为 private 来 模拟 只 读 属性 ， 如 下 所 示 : 

public string Name { get; private set,; } 

目 动 属性 为 减少 样板 代码 立 下 了 汗 瑟 功劳 。 虽 然 只 在 要 求 简 蛙 读 写 操作 
的 情况 下 自动 属性 才能 发 挥 作用 ， 但 根据 我 的 经 验 ， 在 实际 编码 中 这 样 
的 场景 很 常见 。 


如 前 所 述 ， 自 动 属性 与 LINQ 并 无 直接 关系 。 下 面 介绍 对 LINQ 贡 献 突 出 
的 特性 ， 隐 式 类 型 的 局 部 变量 和 隐 式 类 型 数组 ，。 


3.2” 隐 式 类 型 
为 了 清楚 地 描述 C# 3 的 新 特性 ， 首 先 需要 定义 几 个 术语 。 
3.2.1 类 型 术语 
可 以 用 多 个 术语 来 描述 编程 语言 与 其 类 型 系统 的 交互 方式 。 有 些 人 用 弱 
类 型 (weakly typed) 和 强 类 型 (strongly typed) 来 区 分 ， 不 过 我 个 人 
并 不 倾 癌 于 这 样 的 定义 。 这 两 个 术语 缺乏 明确 的 定义 ， 开 发 人 员 在 理解 
上 会 产生 分 上 靶 。 人 们 对 类 型 系统 的 另外 两 种 描述 更 具 共 识 ， 它 们 是 静态 
类 型 和 动态 类 型 、 显 式 类 型 和 隐 式 类 型 。 下 面 依次 介绍 。 
1. 静态 类 型 和 动态 类 型 
静态 类 型 的 语言 是 典型 的 面 同 编译 的 语言 : 所 有 表达 式 的 类 型 都 由 


编译 如 来 决定 ， 并 由 编译 器 来 检查 类 型 的 使 用 是 舍 合 法 。 假 设 要 调 
用 对 象 中 的 方法 ， 编 译 器 可 以 通过 类 型 信息 来 查找 合适 的 方法 。 碍 




















找 的 依据 包括 : 调用 方法 的 表达 式 的 类 型 、 方 法 名 称 、 实 参 的 类 型 
和 个 数 。 这 种 决定 茶 个 表达 式 “ 具 体 含义 ”( 调 用 哪个 方法 、 访 问 哪 
个 字段 ， 等 等 ) 的 过 程 称 为 绑 定 。 动 态 类 型 的 语言 把 绝 大 部 分 甚至 
所 有 绑 定 操作 放 到 了 执行 期 。 


说 明 C# 中 有 些 表达 式 在 源码 层面 不 具有 类 型 信息 ， 比 如 
nul1， 但 是 编译 希 总 是 可 以 根据 表达 式 所 在 上 下 文 推 朵 出 其 类 
型 ， 然 后 根据 该 类 型 来 检查 表达 式 的 使 用 是 否 正 确 。 


C# 总 体 上 属于 静态 类 型 语言 〈 不 过 C# 4 引入 了 动态 绑 定 ， 第 4 章 将 
详 述 ) 。 尽 管 具体 调用 虚 函 数 的 哪个 实现 取 雇 于 执 行 期 调用 对 象 的 
类 型 ， 但 是 执行 方法 签名 绑 定 的 整个 过 程 都 发 生 在 编译 时 。 


2. 显 式 类 型 和 隐 式 类 型 


在 显 式 类 型 语言 中 ， 源 码 会 显 式 地 给 出 所 有 相关 的 类 型 信息 ， 包 括 
局 部 变量 、 字 段 、 方 法 参数 或 者 返回 类 型 。 隐 式 类 型 语言 则 允许 开 
发 人 员 不 给 出 具体 的 类 型 信息 ， 而 是 通过 其 他 机 制 〈 编 译 器 或 者 执 
行 期 的 其 他 方式 ) 根据 上 下 文 推 新 出 类 型 。 


C# 总 体 上 属于 显 式 类 型 ， 不 过 在 C# 3 之 前 ， 就 已 经 出 现 了 隐 式 类 型 
的 身影 ， 例 如 2.1.4 节 提 到 的 对 泛 型 类 型 实 参 的 类 型 推断 机 制 。 另 

外 ， 隐 和 式 类 型 转换 的 出 现 《〈 比 如 从 int 到 long 的 转换 ) ， 也 削弱 了 

C# 的 显 式 类 型 特征 。 

介绍 完了 类 型 分 类 的 基础 知识 ， 下 面 探 讨 C# 3 中 有 关 隐 式 类 型 的 相 
关 特 性 ， 首 先是 隐 式 类 型 的 局 部 变量 。 


3.2.2 ” 隐 式 类 型 的 局 部 变量 


隐 式 类 型 的 局 部 变量 指使 用 上 下 文 关 键 字 var 声 明 的 变量 。 该 声明 方式 
与 使 用 类 型 关键 字 声 明 的 变量 不 同 。 
var language = "C#"， 


使 用 var 关 键 字 来 声明 局 部 变量 ， 其 结果 依然 是 一 个 类 型 确定 的 局 部 变 
量 。 唯 一 的 区 别 是 ， 不 再 明确 写 出 类 型 信息 ， 而 是 由 编译 器 根据 变量 的 
































赋值 在 编译 时 推断 出 来 。 因 此 以 上 代码 还 是 会 生成 ; 
string language = "C#"，; 


提示 C#3 刚 推出 的 时 候 ， 很 多 开发 人 员 刻 意 规避 使 用 var 声 明 变 
量 。 他 们 认为 使 用 var 会 减少 很 多 编译 时 类 型 检查 ， 或 者 导致 执行 
期 出 现 性 能 问题 。 其 实 完全 多 虑 了 ， 它 只 是 用 于 推断 局 部 变量 的 类 
型 。 隐 式 声明 的 变量 与 显 式 声明 的 变量 的 行为 完全 一 致 。 
基于 类 型 推断 的 执行 过 程 ， 可 以 得 出 关于 隐 式 类 型 局 部 变量 的 两 条 重要 
的 使 用 规则 : 
。 变量 在 声明 时 就 必须 被 初始 化 ; 
。 用 于 初始 化 变量 的 表达 式 必须 已 经 具备 某 个 类 型 。 
违反 上 述 规则 的 例子 如 下 : 
var Xx; (本 行 及 以 下 1 行 ) 没有 提供 初始 值 
x = 10， 









































var y = null; <------ 初始 值 没 有 类 型 


其 实在 某 些 情况 下 ， 编 译 器 可 以 通过 分 析 变 量 的 所 有 赋值 语句 来 推断 变 
量 的 类 型 ， 这 样 就 能 打破 上 述 两 条 规则 。 有 一 些 语言 选择 了 这 样 的 方 
式 ， 但 Ck 设计 团队 不 诛 将 类 型 推断 的 过 程 复杂 化 ， 因 此 保 尘 了 更 为 简单 
4 设计 。 


关于 var 关 键 字 还 有 一 项 限制 :只 能 用 于 局 部 变量 。 我 一 直 很 将 望 用 上 
隐 式 类 型 的 字段 ， 可 惜 总 不 能 如 愿 ( 直 到 C# 7.3 也 未 出 现 ) 。 


前 面 的 例子 还 没有 展现 出 var 的 优势 ， 因 为 即使 采用 显 式 声明 方式 也 不 
影响 代码 的 灵活 性 和 可 读 性 。var 主 要 适用 于 以 下 3 种 场景 。 


。 变量 为 匿名 类 型 ， 不 能 为 其 指定 类 型 。3.4 节 会 讨论 匿名 类 型 ， 它 

是 与 LINQ 相 关 的 一 项 特性 。 

变量 类 型 名 过 长 ， 并 且 根 据 其 初始 化 表达 式 可 以 轻松 推 上 新 出 类 型 。 

并 且 初 始 化 表达 式 可 以 提供 足够 的 信息 


关于 第 1 种 情况 ，3.4 节 会 给 出 示例 。 对 于 第 2 种 情况 ， 假 设 要 创建 一 个 

















用 于 映射 decimal 数 据 和 对 应 名 称 的 字典 ， 如 条 采用 显 式 类 型 声明 ， 代 
码 如 下 所 示 : 


Dictionary<string, List<decimal>> mapping = 
new Dictionary<string, List<decimal>>(); 











代码 元 长 且 不 美观 ， 还 需要 折 行 才能 在 本 页 中 显示 。 下 面 改 用 var: 


var mapping = new Dictionary<string, List<decimal>>(); 


效果 相同 ， 但 代码 更 少 ， 同 时 减少 了 注意 力 的 分 散 。 当 然 ， 只 有 当 所 需 
变量 类 型 与 初始 化 表达 式 类 型 完全 一 致 时 ，var 才 适用 。 如 果 所 需 的 变 
量 是 IDictionary<string， List<decimal>> (是 接口 ， 而 不 是 类 ) ，var 
融 不 起 作用 了 。 但 是 ， 对 于 局 部 变量 来 说 ， 接 口 和 实现 之 间 的 这 种 不 一 
臻 通常 并 不 会 造成 影响 ，。 


在 编写 本 书 第 1 版 时 ， 我 对 于 隐 式 类 型 局 部 变量 的 使 用 还 是 小 心 跟 中 。 
除了 LINQ 和 需要 和 直接 调用 构造 器 的 情况 ， 我 很 少 用 到 该 特性 。 当 时 我 
担心 将 来 重读 代码 时 会 难以 区 分 变量 的 类 型 。 


一 晃 十 多 年 过 去 了 ， 当 时 的 顾虑 早已 消除 。 不 管 是 在 测试 代码 中 ， 还 是 
在 产品 代码 中 ， 局 部 变量 的 声明 几乎 是 var 的 天 下 。 绝 大 多 数 情况 下 ， 
我 通过 检视 就 能 推 新 出 变量 类 型 。 对 于 不 好 推 类 的 情况 ， 就 果断 使 用 显 
式 类 型 声明 。 


我 不 是 教条 主义 者 ， 不 会 强 推 我 个 人 的 习惯 编码 。 显 式 类 型 和 隐 式 类 型 
的 变量 最 终 产 生 的 代码 相同 。 将 来 任何 时 候 都 能 目 由 地 从 一 种 方式 切换 
到 另外 一 种 方式 。 我 建议 最 好 与 同事 或 者 开源 合作 者 进行 友好 协商 ， 找 
到 大 家 都 认可 的 平衡 点 ， 并 一 以 贯 之 ， 毕 葛 这 些 人 和 你 的 代码 接触 最 

多 。C# 3 中 关于 隐 式 类 型 的 其 他 特性 有 所 不 同 。 这 些 特性 和 var 关 键 字 
0 


3.2.3” 隐 式 类 型 的 数组 


有 时 会 有 这 样 的 需求 : 创建 一 个 数组 ， 但 是 暂时 不 需要 添加 数据 ， 所 有 
元 素 都 保持 默认 值 。 创 建 这 样 的 数组 的 语法 从 C# 1 一 直 沿 用 至 今 : 


int[] array = new int[10]; 


























但 是 我 们 经 负 也 会 需要 用 一 些 特定 的 值 来 初始 化 数组 。 在 C# 3 之 前 ， 可 
以 及 用 以 下 两 种 形式 : 


int[] arrayl 
int[] array2 


3 
法 : 


{ 二 2, 3/ 4, 5}; 
new int[] { 1, 2, 3, 4, 5}; 











int[] array; 
array = { 1, 2, 3, 4; 5 }; <------ 非法 


第 2 种 初始 化 方式 则 不 受 此 规则 限制 : 

array = new int[] { 1, 2, 3, 4, 5 }; 

C# 3 引入 了 第 3 种 方式 : 数组 为 隐 式 类 型 ， 其 类 型 由 元 素 的 类 型 决定 。 
array = new[] { 1, 2, 3, 4, 5 }; 


只 要 编译 右 可 以 根据 元 素 的 类 型 来 推断 数组 的 类 型 ， 上 述 方式 就 可 以 目 
由 使 用 。 对 于 多 维 数组 ， 这 同样 适用 : 


var array = new[,] { {1,2,3},14,5,6}}; 


编译 项 是 如 何 进行 类 型 推 新 的 呢 ? 列 出 所 有 可 能 情况 来 精确 描述 整个 过 
程 太 过 复杂 ， 这 里 只 描述 一 下 大 致 流程 。 


(1) 统计 每 一 个 元 素 的 类 型 ， 将 这 些 类 型 整合 成 一 个 类 型 候选 集 。 
(2) 对 于 类 型 候选 集中 的 每 一 个 类 型 ， 检 查 是 否 所 有 元 系 都 可 以 隐 式 地 


转换 为 该 类 型 。 剔 除 不 满足 该 检查 条 件 的 类 型 ， 最 终 得 到 一 个 粒 选 过 的 
类 型 集 。 


(3) 如 果 该 类 型 集中 只 剩 一 个 类 型 ， 则 该 类 型 就 是 推断 出 来 的 元 素 类 
型 ， 编 译 器 根据 该 类 型 来 创建 合适 的 数组 。 如 果 类 型 集中 类 型 的 数量 为 
0 或 大 于 1， 则 编译 时 会 报错 。 


最 终 得 到 的 类 型 必须 是 初始 化 器 中 东 个 表达 式 的 类 型 。 编 译 器 不 会 去 碍 
找 这 些 表达 式 寻找 的 共同 基 类 或 接口 。 表 3-1 通 过 具体 例子 展示 了 上 述 























规则 。 
表 3-1 隐 式 类 型 数组 的 类 型 推 关 示例 


ee eo reins 








所 有 元 素 均 不 具有 类 型 


string 是 唯一 候选 类 型 ， 并 且 nul11 可 
以 转换 为 string 类 型 


候选 类 型 有 两 个 : string 和 
隐 式 转换 


候选 类 型 有 两 个 : int 和 pateTime， 但 
是 两 个 类 型 不 能 相互 转换 


int 是 唯一 候选 类 型 ， 但 nul1 不 能 转 
为 int 类 型 





隐 式 类 型 数组 的 主要 作用 还 是 减少 代码 元 余 ， 但 有 一 种 情况 除外 ， 那 就 
征 和 匿名 类 型 搭配 使 用 时 只 能 使 用 隐 式 类 型 数组 ， 而 不 能 显 式 地 指定 类 
型 。 即 便 如 此 ， 隐 陈 类 型 数组 依然 是 开 及 人 员 手 中 不 可 或 缺 的 一 把 利 
器 。 








下 一 个 特性 依然 延续 了 “让 创建 和 初始 化 对 象 更 简单 * 的 主题 ， 但 在 实现 
方式 上 有 所 不 同 。 


3.3 对象 和 集合 的 初始 化 


使 用 对 象 初始 化 占 和 集合 初始 化 器 ， 可 以 让 通过 初始 化 值 来 创建 新 对 
象 或 新 集合 变 得 更 简单 : 仅 需 一 个 表达 式 即 可 完成 创建 。 此 项 功能 对 于 
LINQ 来 说 十 分 重要 ， 这 是 由 其 三 询 语句 的 转译 方式 决定 的 。 力 外 ， 这 
两 个 初始 化 器 在 其 他 一 些 场景 也 大 有 用 处 。 该 特性 要 求 对 象 类 型 必须 是 
可 变 类 型 ， 这 一 要 求 在 编写 函数 风格 的 代码 时 会 比较 烦人 ; 但 应 用 得 当 
会 大 有 功效 。 在 深入 其 细节 之 前 ， 先 看 一 个 简单 的 示例 。 


3.3.1 对 象 初始 化 器 和 集合 初始 化 器 简介 
举 一 个 非 营 简单 的 例子 : 一 个 电子 商务 系统 的 订单 模型 。 以 下 代码 包括 


order、Ccustomer 和 orderItem 3 个 类 。 
代码 清单 3-1 电子 商务 系统 订单 模型 


public class Order 





private readonly List<orderItem> items = new List<OrderIitem>( 


public string OrderId { get; set; } 
public Customer Customer { get; set; } 
public List<orderItem> Items { get { return items; } } 


} 


public class Customer 
public string Name { get; set; } 
public string Address { get; set; } 
} 
public class OrderItenm 
public string ItemId { get; set; } 


public int Quantity { get; set; } 
} 


该 如 何 创 建 一 个 订单 呢 ? 首先 创建 一 个 order 的 实例 ， 然 后 为 orderId 和 


customer 两 个 属性 赋值 。 不 能 直接 为 Items 属 性 赋值 ， 因 为 它 是 只 读 属 

性 。 可 以 先 获取 Items 对 象 ， 然 后 癌 其 添加 元 素 。 假 定 我 们 不 能 修改 类 

人 
0 不 。 


O00 不 使 用 对 象 初始 化 器 和 集合 初始 化 器 创建 和 添加 订 





var customer = new Customer(); (本 行 及 以 下 2 行 ) 创建 Customer 
customer .Name = "Jon"; 
customer .Address = "UK"; 





var item1 = new OrderItem(); (本 行 及 以 下 2 行 ) 创建 第 1 个 OrderItem 
Item1. ItemId = "abcd123" ， 
Item1l,Quantity = 1; 





var item2 = new OrderItem(); (本 行 及 以 下 2 行 ) 创建 第 2 个 OrderItem 
Item2 .ItemId = "fghi456"; 
Item2 ,Quantity = 2; 





var order = new Order(); (本 行 及 以 下 4 行 ) 创建 order 
order,.orderId = "xyz"; 

order ,Customer = customer; 
order.Items.Add(item1); 

order.Items.Add(item2); 


以 上 代码 可 以 进一步 简化 : 给 类 添加 融 参 数 的 类 构造 器 ， 然 后 通过 构造 
融 为 属性 赋 初 始 值 。 即 便 有 了 对 象 初 始 化 右 和 集合 初始 化 器 ， 我 也 会 尽 
量 采用 构造 器 的 方式 ， 但 是 简便 起 见 ， 这 里 需要 假定 由 于 茶 种 不 可 抗力 
〈 例 如 我 们 没有 源码 修改 权限 ) ， 无 法 为 类 添加 构造 器 。 使 用 对 象 初始 
化 强 和 集合 初始 化 器 ， 创 建 并 初始 化 的 过 程 就 可 以 化 繁 为 人 镜 了 。 


De 使 用 对 象 初始 化 器 和 集合 初始 化 占 来 创建 和 添加 订 


var order = new Order 


{ 
OrderId = "xyz", 
Customer = new Customer { Name = "Jon", Address = "UK" }, 
Items = 


new OrderIitem { ItemId 
new OrderIitem { ItemId 


"abcd123", Quantity 
"fghi456", Quantity 


ll 有 
DP 


} 
}; 


在 我 看 来 ， 代 码 清 单 3-3 要 比 代码 清单 3-2 可 读 性 强 。 由 于 采用 了 缩 进 ， 
对 象 的 整个 结构 看 起 来 更 清晰 ， 而 且 代 码 元 余 也 相应 减少 了 。 下 面 逐 部 
分 地 继续 深入 探究 代码 细 市 。 


3.3.2” ”对象 初始 化 器 


从 语法 上 讲 ， 对 象 初始 化 器 融 是 由 大 括号 包围 的 一 系列 成 员 初 始 化 器 。 
每 个 成 员 初 始 化 器 的 形式 是 property = initializer-value， 其 中 
property 是 用 于 初始 化 的 字段 或 者 属性 的 名 称 ，initializer-value 是 表 
达 式 、 集 合 初 始 化 器 或 者 其 他 对 象 初始 化 器 。 


说 明 对象 初 始 化 费 第 和 属性 搭配 使 用 ， 这 也 是 本 革 代 码 所 采用 的 
方式 。 字 段 没有 访问 器 ， 但 也 可 以 采用 类 似 于 等 价 的 方式 : get 访 
问 器 相当 于 字段 的 读 操作 ，set 访 问 器 相当 于 字段 的 写 操作 。 


对 象 初始 化 器 只 能 用 于 构造 器 调用 或 者 其 他 对 象 初始 化 器 中 。 此 时 的 构 
造 器 和 普通 构造 器 一 样 ， 也 可 以 拥有 参数 。 如 果 不 需 要 指定 参数 ， 那 么 
参数 列表 () 也 可 以 省 去 不 写 ， 它 等 于 提供 了 一 个 空 的 参数 列表 。 例 如 下 
面 两 种 写法 是 等 价 的 : 


new Order() { OrderId = "xyz" }; 
new Order { OrderId = "xyz" }; 











Order order 
Order order 


注意 ， 只 有 在 使 用 对 象 初始 化 器 或 者 集合 初始 化 费时 ， 构 造 占 的 参数 列 
表 才 可 以 和 省略。 下 面 这 种 写法 是 非法 的 : 


Order order = new Order; 非法 


对 象 初 始 化 器 的 作用 只 是 表达 应 该 如 何 初始 化 每 个 属性 。 如 采 初 始 化 值 
《= 右边 的 内 容 ) 是 一 个 普通 的 表达 式 ， 那 么 会 先 计算 该 表达 式 的 值 ， 
然后 将 结果 传 给 属性 对 应 的 set 访 问 堪 。 代 码 清单 3-3 的 大 部 分 内 容 遵 循 
该 模式 ， 只 有 Items 属 性 采用 的 是 集合 初始 化 器 ， 稍 后 会 讲 到 。 


如 果 初 始 化 值 是 为 一 个 对 象 初始 化 莫 ， 则 不 会 调用 set 访 问 费 ， 而 会 调 
用 get 访 问 器 ， 然 后 将 藤 套 对 象 初始 化 需 得 到 的 结果 应 用 于 由 get 访 问 需 
返回 的 属性 。 代 码 清单 3-4 创 建 了 一 个 HttpClient 对 象 ， 并 对 每 个 及 送 的 











请 求 都 修改 其 默认 请 求 头 的 内 容 。 代 码 中 选择 设置 请 求 头 的 From 和 pate 
两 个 属性 ， 是 因为 它们 的 值 最 简单 。 


代码 清单 3-4 通过 内 套 的 对 象 初始 化 器 来 修改 一 个 新 创建 的 
HttpCclient 对 象 的 默认 请 求 头 


HttpClient client = new HttpClient 











DefaultRequestHeaders = <------ 为 DefaultRequestHeaders 调 用 的 尾 
From = "userQ@example.com", <------ 为 From 调 用 的 属性 set 访 问 器 
Date = DateTimeOffset.UtcNow <------ 为 Date 调 用 的 属性 set 访 问 

} 


}; 
它 等 同 于 以 下 代码 : 


HttpClient client = new HttpClient(); 

var headers = client.DefaultRequestHeaders; 
headers .From "UserQ@example.com"; 
headers.Date DateTimeoffset ,UtcNow:， 


一 个 对 象 初始 化 器 在 其 成 员 初 始 化 序列 中 ， 可 以 包含 多 个 和 藤 套 的 对 象 初 
始 化 器 、 集 合 初始 化 器 、 普 通 表 达 式 。 下 面 介绍 集合 初始 化 器 。 


3.3.3 ”集合 初始 化 器 


集合 初始 化 器 的 语法 : 用 大 括号 包围 初始 化 元 素 ， 各 个 元 系 之 间 以 逗号 
分 隔 。 初 始 化 元 系 可 以 是 一 个 表达 式 ， 也 可 以 是 另 一 个 集合 初始 化 器 。 
集合 初始 化 器 只 能 用 于 构造 器 调用 或 者 对 象 初始 化 器 中 。 另 外 ， 集 合 初 
始 化 堪 对 于 集合 元 系 的 类 型 也 有 限制 ， 稍 后 会 讲 到 。 代 码 清单 3-3 展 示 
了 在 一 个 对 象 初 始 化 器 中 使 用 集合 初始 化 器 《〈 人 代码 中 加 粗 的 部 分 ) 。 


var order = new Order 











orderId = "xyz", 


Customer = new Customer { Name = "Jon", Address = "UK" }, 
Items = 
new OrderIitem { ItemId = "abcd123", Quantity = 1 }, 
new OrderItem { ItemId = "fghi456", Quantity = 2 } 


集合 初始 化 器 多 用 于 创建 新 集合 。 下 面 这 行 代码 创建 了 一 个 字符 串 集 合 
并 为 其 添加 初始 值 : 


var beatles = new List<string> { "John", "Paul", "Ringo", "George 


0 其 后 紧 跟 一 系列 Add 方 法 
调用: 


var beatles = new List<string>(); 
beatles.Add("John"); 
beatles.Add("Paul"); 
beatles.Add("Ringo"); 
beatles.Add("George"); 


如 果 当 前 集合 并 不 具备 这 样 的 单 参数 Add 方 法 呢 ? 这 时 就 需要 用 大 括号 
包围 初始 化 元 素 。 除 了 List<T>， 使 用 频 度 最 高 的 泛 型 集合 应 该 

是 Dictionary<TKey，TValue> 了 。 它 添加 元 素 的 方法 是 Add(key， 
value)， 因 此 可 以 如 下 所 示 使 用 集合 初始 化 器 : 


var releaseYears = new Dictionary<string, int> 








{ "Please please me", 1963 }, 
{ "Revolver", 1966 }, 
{ "Sgt. Pepper's Lonely Hearts Club Band", 1967 }, 
{ "Abbey Road", 1970 } 
}; 


编译 器 把 每 个 元 素 初 始 化 器 都 看 作 一 个 Add 调 用 。 如 果 元 素 初 始 化 颖 没 
有 大 括号 ， 则 将 其 作为 单个 参数 传递 给 Add 方 法 。 前 面 List<string> 代 码 
中 的 集合 初始 化 器 束 是 这 种 方式 。 


如 果 元 素 初 始 化 器 珊 有 大 括号 ， 依 然 按照 Add 方 法 的 单个 调用 来 处 理 ， 
全 0 的 每 个 表达 式 都 当 作 一 个 参数 。 上 述 字典 的 例子 等 
司 于 如 下 代码 ; 


var releaseYears = new Dictionary<string, int>(); 
releaseYears.Add("Please please me", 1963); 
releaseYears.Add("Revolver", 1966); 

releaseYears.Add("Sgt. Pepper's Lonely Hearts Club Band", 1967); 
releaseYears.Add("Abbey Road", 1970); 

















接 下 来 会 正常 执行 章 载 决议 : 它 负责 得 找 最 合适 的 Add 方 法 。 如 果 是 泛 
型 的 dd 方法， 还 要 需要 执行 类 型 推 其 。 


只 有 实现 了 IEnumerable 接 口 的 类 型 才能 够 使 用 集合 初始 化 器 ， 但 实现 
IEnumerable<T> 接 口 并 不 是 必然 要 求 。C# 语 言 的 设计 团队 曾 裔 历 
framework 来 查找 那些 具备 Add 方 法 的 类 型 ， 最 终 确 定 区 分 集合 类 和 非 集 
合 类 的 最 佳 方式 束 是 检查 该 类 型 是 否 实 现 了 IEnumerable 接 口 。 试 想 
DateTime.Add(Timespan) 方 法 ， 显 然 pateTime 不 是 一 个 集合 类 ， 虽 然 它 


具备 Add 方 法 ， 但 它 不 能 使 用 集合 初始 化 器 : 
DateTime invalid = new DateTime(2020, 1, 1) { TimeSpan.FromDays(1 


编译 器 在 编译 集合 初始 化 器 时 ， 并 不 需要 IEnumerable 的 具体 实现 。 因 
此 ， 有 了 时 在 测试 项 目 中 可 以 这 样 做 : 使 用 包含 Add 方 法 的 类 型 ， 并 且 让 
该 类 型 实现 IEnumerable 接 口 ， 实 现 中 只 抛 出 一 

个 NotImplementedException。 这 样 做 便于 构造 测试 数据 ， 但 是 并 不 建议 
在 产品 代码 中 采用 这 种 方式 。 我 希望 能 有 一 个 单独 的 attribute 来 负责 指 
示 该 类 型 是 否 适用 于 集合 初始 化 器 ， 这 样 束 可 以 不 用 额外 实现 
IEnumerable 接 口 『， 可 惜 未 能 如 愿 。 


3.3.4 _ 仅 用 单一 表达 式 束 能 完成 初始 化 的 好 处 


读者 可 能 会 好 奇 : 这 些 特性 对 于 LINQ 有 什么 用 呢 ? 前 面 曾 提 过 ， 几 乎 
C# 3 的 所 有 特性 都 是 为 LINQ 服 务 的 ， 那 么 对 象 初始 化 器 和 集合 初始 化 
器 的 作用 何在 呢 ? 答案 就 是 : 与 LINQ 相 关 的 其 他 特性 都 要 求 代码 具备 
单一 表达 式 的 表达 能 力 。 例 如 在 一 个 查询 表达 式 中 ， 对 于 一 个 给 定 的 
输入 ，select 子 名 不 文 持 通过 多 条 语句 生成 结果 。) 


这 种 仅 用 一 个 表达 式 就 能 够 初始 化 对 象 的 能 力 ， 其 作用 不 仅 限 于 
LINQ， 还 有 助 于 简化 字段 初始 化 器 、 方 法 实 参 甚至 是 条 件 表 达 式 ?:， 
对 于 静态 字段 初始 化 器 构建 查找 表 更 是 有 奇效 。 不 过 如 果 初 始 化 表达 式 
变 得 太 过 庞大 ， 仍 需要 对 其 进行 拆 分 。 

而 且 这 项 特性 于 其 上 自身 也 意义 重大 。 如 果 没 有 对 象 初 始 化 器 来 创建 
orderItem 对 象 ， 那么 在 为 order .Items 属 性 添加 元 素 时 ， 集合 初始 化 器 
的 便捷 性 也 会 有 所 折 损 。 


后 面 每 当 提 到 一 个 新 特性 或 改进 特性 (比如 3.5 节 中 的 lambda 表 达 式 或 






































8.3 节 中 的 表达 式 主 体 成 员 ) 对 单一 表达 式 有 所 页 献 时 ， 正 是 对 象 初始 
化 器 和 集合 初始 化 器 让 该 特性 变 得 更 出 众 。 


对 象 初 始 化 器 和 集合 初始 化 需 让 创建 和 初始 化 类 型 实例 变 得 更 简 活 ， 但 
前 提 是 已 有 合适 的 类 型 用 于 创建 。 下 一 个 特性 是 匿名 类 型 ， 它 让 我 们 在 
创建 对 象 前 无 须 预 先 声明 一 个 类 型 。 这 个 逻辑 听 起 来 比较 绕 ， 但 实际 上 
不 难 理解 。 


3.4 匿名 类 型 
使 用 匿名 类 型 ， 无 须 预先 声明 一 个 类 型 便 能 创建 静态 类 型 对 象 。 听 起 来 


当前 类 型 应 该 是 在 执行 期 动态 创建 的 ， 但 是 实际 过 程 要 更 微妙 。 下 面 介 
和 
性 。 

















3.4.1 基本 语法 和 行为 


解释 匿名 类 型 ， 最 简单 的 方式 还 是 举例 子 。 代 码 清单 3-5 展 示 了 如 何 创 
娃 一 个 包含 Name 和 Score 两 个 属性 的 对 象 。 


代码 清单 3-5 ”一 个 有 Name 和 Score 属性 的 匿名 类 型 


var player = new (本 行 及 以 下 4 行 ) 创建 一 个 匿名 类 型 的 对 象 ， 包 含 Name 和 Score 
{ 








Name = "Rajesh", 
Score = 3500 
}; 


Console .writeLine("Player name: {0}"，player.Name); (本 行 及 以 下 1 行 ) 

Console.writeLine("Player Score: {0}", player.Sscore); 

这 个 简短 的 例子 揭示 了 匿名 类 型 的 几 个 要 素 。 

。 匿名 类 型 的 语法 类 似 于 对 象 初始化 问 ， 但 无 须 指 定 闫 型 名 称 ， 只 需 
要 new 天 键 字 、 左 大 括号 、 属 性 以 及 右 大 括号 。 这 一 形式 称 为 匿名 
对 和 象 创建 表达 式 。 其 中 属性 部 分 可 以 继续 藤 套 匿名 对 象 创建 表达 


式 。 
声明 player 释 量 使 用 7 了 var 关键 字 。 因 为 所 创建 的 类 型 是 匿名 类 
型 ， 所 以 只 能 用 var 来 声明 (也 可 以 使 用 object 来 声明 ， 不 过 意义 








不 人 了 
。 以 上 代码 依然 属于 静态 类 型 的 范畴 。Visual Studio 会 为 player 变 量 
自动 设置 Name 和 Score 属性 。 如 果 要 访问 一 个 不 存在 的 属性 《比如 
player.Points) ， 则 编译 右 会 报错 。 属 性 的 类 型 是 根据 赋值 的 类 
型 进行 推断 的 : player .Name 是 string 类 型 ， player .Score 是 int 类 
型 。 


以 上 便 是 对 匿名 类 型 的 基本 介绍 。 匿 名 类 型 有 哪些 用 途 呢 ? 这 就 涉及 

LINQ 了 。 当 执行 一 个 查询 时 ， 不 管 被 碍 询 的 数据 源 是 SQL 数据 库 还 是 

对 象 集合 ， 经 常 需要 一 种 特定 的 、 不 同 于 源 数据 、 只 在 查询 语句 中 有 意 
义 的 数据 形态 。 


假设 有 一 个 集合 ， 集 合 中 每 个 人 都 有 最 喜欢 的 颜色 。 我 们 需要 把 查询 结 
果 绘 制 成 一 张 直方 图 ， 该 查询 结果 集 按照 颜色 和 喜欢 该 颜色 的 人 数 进 行 
划分 ， 于 是 这 个 数据 形态 所 代表 的 含义 只 在 这 个 特定 的 上 下 文中 有 意 

义 。 使 用 匿名 类 型 可 以 更 精练 地 表达 这 种 “一 次 性 ”的 类 型 需求 ， 同 时 还 
不 失 静 态 类 型 的 优势 。 


对 比 Java 中 的 匿名 类 


熟悉 Java 语 言 的 读者 ， 可 能 会 好 奇 Java 中 的 匿名 类 〈anonymous 
class) 和 C# 的 匿名 类 型 之 间 的 关系 。 虽 然 二 者 名 称 比较 相近 ， 但 是 
不 论 从 语法 还 是 用 途上 讲 ， 都 有 着 显著 差别 。 


纵 观 历史 ，Java 中 的 匿名 类 主要 用 于 实现 接口 或 者 扩展 抽象 类 ， 以 
便 履 兰 茶 一 两 个 方法 。C# 的 匿名 类 型 不 是 用 于 实现 接口 或 者 继承 类 
.0bject 除 外 ) ， 该 特性 主要 与 数据 相关 而 不 是 与 代码 相 






































C# 还 提供 了 一 个 关于 匿名 对 象 创建 表达 式 的 简化 形式 ， 利 用 这 种 形式 ， 
可 以 从 其 他 对 象 复制 属性 或 字段 到 新 对 象 中 ， 并 且 二 者 的 属性 或 字段 名 
称 相同 。 该 语法 称 为 投射 初始 化 器 。 借 用 之 前 的 电子 商务 的 数据 模型 ， 
有 如 下 3 个 类 : 








OrderId、 Customer、Items 
Name、Address 
ItemId、Quantity 


e@e Order 
@ Customer 
e OrderIitem 











代码 中 可 能 会 需要 一 个 特定 的 order 对 象 ， 该 对 象 包含 以 上 所 有 属性 
值 。 假 设 已 有 order、customer 和 item 这 几 个 类 型 的 对 象 ， 那 么 可 以 很 轻 
松 地 利用 它们 来 创建 一 个 匿名 类 型 : 


Var flattenedItem = new 


order .OrderId, 

CustomerName = customer.Name, 
customer.Address, 
item.ItemId, 

item.Quantity 


}; 

在 这 个 例子 中 ， 除 了 customerName， 其 他 属性 都 使 用 了 投 冉 初 始 化 器 。 
00 0 0 0 
同 的 : 


Var flattenedItem = new 





OrderId = order.orderId ， 
CustomerName = customer.Name, 
Address = customer.Address, 
ItemId = item.ItemId, 
Quantity = item.Quantity 


}; 

如 果 需 要 从 一 个 查询 操作 中 筛选 出 部 分 属性 ， 或 者 需要 把 多 个 对 象 合并 
成 一 个 匿名 对 象 ， 投 射 初 始 化 器 更 有 效 。 在 进行 复制 时 ， 如 果 目 标 属 性 
或 字段 的 名 称 与 源 名 称 一 致 ， 那 么 可 以 交 由 编译 器 来 推 采 名 称 ， 如 以 下 





SomeProperty = variable.SomeProperty 


可 以 直接 简化 为 : 


variable.SomeProperty 


在 复制 多 个 属性 时 ， 使 用 投射 初始 化 器 可 以 大 幅 减少 代码 元 余 。 如 末 能 
0 


重 构 与 投射 初始 化 器 


尽管 以 上 两 种 形式 的 代码 的 结果 相同 ， 但 并 不 代表 二 者 的 行为 也 完 
人 o 如 果 把 Add ress 属 性 重 命名 为 CustomerAdd ress 会 怎么 样 2? 


在 使 用 投射 初始 化 器 的 代码 版 本 中 ， 匿 名 类 型 的 属性 名 称 也 会 随 之 





改变 ， 而 在 显 式 指定 属性 名 称 的 代码 版 本 中 ， 属 性 名 称 不 会 变化 。 
人 ee A 


关于 匿名 类 型 的 语法 就 介绍 到 这 里 。 匿 名 类 型 的 属性 使 用 起 来 与 普通 类 
型 的 属性 没有 差别 ， 那 么 其 背后 的 机 制 是 怎样 的 呢 ? 


3.4.2 ”编译 器 生成 类 型 


虽然 源码 中 没有 出 现 匿名 类 型 的 名 称 ， 但 编译 器 需要 为 它 生 成 一 个 类 


型 。 














它 在 执行 期 没有 任何 特殊 之 处 ， 对 于 执行 期 来 说 也 只 是 一 个 普通 的 


类 型 而 已 ， 只 不 过 这 个 类 型 的 名 称 不 是 一 个 有 效 的 C# 名 称 。 关 于 该 类 


型 ， 





有 几 个 比较 有 意思 的 特征 ， 其 中 一 些 得 到 了 语言 规范 层面 的 保证 ， 


另外 一 些 则 没有 。 当 采用 微软 C# 编 译 圳 时 ， 匿 名 类 型 具备 以 下 特 氮 。 


亿 是 二 人 人 关 所 保证 六 5 

其 基 类 是 opject 〈 保 证 ) 。 

该 类 是 密封 的 《〈 不 保证 ， 虽 然 非 密封 的 类 并 没有 什么 优势 ) 。 

性 是 只 读 的 〈 保 证) 。 

Cn 
) 


对 于 程序 集 是 internal 的 〈 不 保证 ， 在 处 理 动态 类 型 时 会 比较 辐 
手 ) 。 

该 类 会 覆盖 GetHashcode() 和 Equals() 方 法 : 两 个 匿名 类 型 只 有 在 所 
有 属性 都 等 价 的 情况 下 才 等 价 。 可 以 正常 处 理 nul1 值 。) 只 保证 
会 敢 盖 这 两 个 方法 ， 但 不 保证 散 列 值 的 计算 方式 。 

敢 盖 并 完善 Tostring() 方 法 ， 用 于 呈现 各 属性 名 称 及 其 对 应 值 。 这 
一 点 不 保证 ， 但 对 于 问题 诊断 来 说 作用 重大 。 

该 类 型 为 泛 型 类 ， 其 类 型 形 参 会 应 用 于 每 一 个 属性 。 具 有 相同 属性 
名 称 但 属性 类 型 不 同 的 匿名 类 型 ， 会 使 用 相同 的 泛 型 类 型 ， 但 拥有 
不 同 的 类 型 实 参 。 这 一 点 不 保证 ， 不 同 编译 右 的 实现 方式 不 同 。 
如 果 两 个 匿名 对 象 创建 表达 式 使 用 相同 的 属性 名 称 ， 有 具有 相同 的 属 
性 类 型 以 及 属性 顺序 ， 并 且 在 同一 个 程序 集中 ， 那 么 这 两 个 对 象 的 


型 











类 型 相同 。 
最 后 一 点 对 于 变量 重新 赋值 、 使 用 匿名 类 型 的 隐 式 类 型 数组 来 说 很 重 
要 。 根 据 我 的 个 人 经 验 ， 一 般 很 少 会 对 由 匿名 类 型 初始 化 的 变量 重新 赋 
值 ， 但 这 么 做 确实 可 行 。 例 如 下 面 的 代码 完全 合法 : 


var player = new { Name = "Pam", Score = 4000 }; 
player = new { Name = "James", Score = 5000 }; 


同样 ， 也 可 以 使 用 匿名 类 型 来 创建 隐 式 类 型 数组 ， 有 具体 的 语法 形式 参见 
3.2.3 节 : 








var players = new[] 
{ 


new { Name = "Priti", Score 6000 }, 
new { Name = "Chris", Score 7000 }, 
new { Name = "Amanda", Score = 8000 }, 


}; 


请 注意 ， 两 个 匿名 类 型 大 要 类 型 相同 ， 那 么 两 个 匿名 对 象 创建 表达 式 中 
的 属性 名 称 、 属 性 类 型 以 及 属性 的 顺序 都 必须 完全 一 致 。 例 如 以 下 代码 
就 是 非法 的 ， 因 为 数组 中 第 2 个 元 素 中 的 属性 顺序 与 其 他 的 不 一 致 


var players = new[] 





new { Name = "Priti" Score = 6000 }, 
new { Score = 7000, Name = Chris 上 
new { Name = "Amandan Score = 8000 }, 





* 管 数组 中 每 个 元 系 蛙 独 看 都 是 合法 的 ， 但 是 由 于 第 2 个 元 系 的 与 众 不 
同 ， 编 译 圳 无 法 推 邮 数组 类 型 。 此 外 ， 增 加 属性 或 者 修改 属性 类 型 这 些 
行为 也 会 导致 对 象 类 型 发 生变 化 。 


尽管 匿名 类 型 在 LINQ 中 大 有 用 处 ， 但 是 它 并 不 适用 于 所 有 场景 。 下 面 
简单 介绍 匿名 类 型 在 哪些 场景 中 不 适用 。 


3.4.3 ”匿名 类 型 的 局 限 性 


匿名 类 型 在 需要 实现 数据 的 局 部 化 表示 时 能 够 发 挥 作用 。 所 谓 局 部 化 ， 
就 是 指 茶 个 数据 形态 的 使 用 范围 限制 在 特定 方法 中 。 如 有 果 需 要 在 多 处 使 

















用 同一 个 数据 形态 ， 匿 名 类 型 束 无 能 为 力 了 。 虽 说 可 以 把 匿名 类 型 的 实 
例 用 于 方法 返回 值 或 者 方法 参数 ， 但 是 必须 使 用 泛 型 或 者 object 类 型 。 
因为 匿名 类 型 不 具名 的 特性 ， 所 以 很 难 应 用 于 方法 签名 之 中 。 


在 C# 7 之 前 ， 如 果 需 要 在 多 个 方法 中 使 用 同一 个 数据 结构 ， 一 般 需 要 声 
明 自 定义 类 或 结构 体 。C# 7 引入 了 元 组 〈 第 11 章 会 介绍 ) ， 元 组 可 作为 
候选 解决 方案 ， 不 过 依然 取决 于 数据 封装 程度 的 需求 。 


说 到 数据 封 朔 ， 需 要 说 明 匿 名 类 型 是 不 提供 任何 数据 封 逆 的。 匿名 类 型 
中 不 能 有 校 验 ， 也 不 能 添加 任何 行为 。 如 果 有 类 似 的 需求 ， 就 只 能 目 定 
义 类 型 ， 而 不 是 使 用 匿名 类 型 。 


前 文 提 到 C# 4 引入 了 动态 类 型 ， 而 通过 动态 类 型 进行 路程 序 集 的 匿名 类 
型 访问 是 很 困难 的 ， 这 是 因为 匿名 类 型 的 internal 必 性。 我 兽 在 MVC 
Web 应 用 中 见 过 类 似 的 尝试 : 页 面 的 model 采 用 匿名 类 型 构建 ， 之 后 在 
view 中 使 用 dynamic 类 型 〈 第 4 章 还 会 阐述 ) 访问 该 匿名 对 象 。 如 果 这 两 
部 分 代码 在 一 个 程序 集中 ， 那 么 是 可 行 的 ， 如 果 包 含 model 代 码 的 程序 
集 通 过 [InternalsvisibleTo] 特 性 来 使 其 内 部 成 员 对 于 包含 view 代 码 的 
其 他 程序 集 设 置 了 可 见 ， 也 是 可 行 的 ， 但 是 这 种 实现 方式 看 起 来 会 比较 
奇怪 。 我 通常 建议 把 model 定 义 为 普通 类 型 ， 不 要 定义 成 匿名 类 型 ， 以 
便 充 分 利用 静态 类 型 的 优势 。 在 这 种 情况 下 ， 虽 然 匿 名 类 型 能 够 暂时 节 
省 时 间 ， 但 从 长 远 来 看 还 是 使 用 普通 类 型 更 好 。 
说 明 Visual Basic 语 言 也 有 匿名 类 型 ， 但 是 它 与 C# 中 的 匿名 类 型 
行为 并 不 相同 。C# 中 的 匿名 类 型 会 将 所 有 属性 用 于 等 价 比 较 和 计算 
散 列 值 ， 并 且 它 们 都 是 只 读 属 性 ， 而 Visual Basic 中 的 匿名 类 型 ， 只 
有 用 key 修饰 符 声 明 的 属性 才 会 参与 上 述 过 程 。 没 有 用 key 修饰 的 属 
性 不 受 读 写 访问 限制 ， 并 且 不 参与 等 价 比 较 和 散 列 值 计 算 。 
至 此 ， 关 于 C# 3 特性 的 介绍 已 经 过 半 ， 这 些 特性 都 和 数据 相关 。 接 下 来 
ee 可 执行 代码 。 首 先 介 绍 lambda 表 达 式 ， 之 后 是 扩展 方 
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3.5 lambda 表达 式 
第 2 章 讲 过 匿名 方法 是 如 何 通 过 内 联 代码 简化 委托 实例 的 创建 的 : 


Action<string> action = delegate(string message) (本 行 及 以 下 3 行 ) 使 ) 









































Console.writeLine("In delegate: {0}", message); 


}; 
action("Message"); <------ 调用 委托 


C# 3 引入 lambda 表 达 式 之 后 ， 这 一 过 程 变 得 更 简洁 了 。 匿 名 函数 这 个 
术语 用 于 指 代 匿名 方法 和 lambda 表 达 式 。 之 后 书 中 会 经 常 使 用 该 术语 ， 
它 在 C# 语 言 规范 中 也 广泛 使 用 。 


说 明 _ lambda 表达 式 这 个 名 称 源 于 lambda 演 算 。lambda 演 算是 数 

学 和 计算 机 科学 界 的 一 个 术语 ， 由 Alonzo Church 于 20 世 纪 30 年 代 提 
出 。 最 初 教会 借用 希腊 字母 A (lambda) 来 表示 函数 (方法 ) ， 因 

此 该 名 称 沿用 至 今 。 


C# 的 设计 团队 出 于 各 种 必要 的 原因 ， 人 花费 大 量 精力 来 简化 委托 实例 的 创 
建 过 程 ， 其 中 LINQ 是 最 重要 的 一 个 原因 。3.7 节 介绍 查询 表达 式 时 ， 会 
讲 到 查询 表达 式 会 被 转译 成 包含 lambda 表 达 式 的 代码 。 即 使 不 利用 查询 
表达 式 ，LINQ 最 终 还 是 需要 在 源码 中 直接 使 用 lambda 表 达 式 。 

接 下 来 首先 介绍 lambda 表 达 式 的 语法 ， 然 后 深入 探 客 其 行为 模式 ， 最 后 
讨论 表达 式 树 是 如 何 将 代码 变 成 数据 表示 形式 的 。 


3.5.1 lambda 表 达 式 语法 简介 

lambda 表 达 式 的 基本 语法 形式 如 下 : 

参数 列表 => 主体 

参数 列表 和 主体 (body) 都 可 以 有 多 种 呈现 形式 。 最 显 式 的 形式 是 : 
lambda 表 达 式 的 参数 列表 与 普通 方法 或 匿名 方法 的 参数 列表 相同 。 同 
样 ，lambda 表 达 式 的 主体 可 以 是 一 个 代码 块 : 用 一 对 大 括号 包围 的 一 组 
语句 。 这 种 形式 的 lambda 表 达 式 与 匿名 方法 差不多 : 


Action<string> action = (string message) => 























Console.writeLine("In delegate: {0}", message); 


/ 
action("Message"); 


这 样 的 lambda 表 达 式 看 起 来 无 甚 奇 竺 ， 不 过 是 用 => 符 号 答 换 了 delegate 














关键 字 而 已 。 但 是 在 特殊 场景 下 ，lambda 表 达 式 可 以 变 得 更 短 。 


首先 简化 主体 部 分 : 如果 主体 只 包含 一 条 return 语 句 或 者 一 个 表达 式 ， 
它 就 可 以 简化 成 只 有 这 一 条 语句 ， 而 且 return 关 键 词 也 可 以 省 上 略 不 写 。 
前 面 的 例子 只 有 一 条 调用 语句 ， 因 此 可 以 简写 成 : 


Action<string> action = 
(string message) => Console.writeLine("In delegate: {0}", mes 


稍 后 会 展示 带 return 语 名 的 例子 。lambda 表 达 式 简化 成 这 种 形式 之 后 ， 
了 
主体 。 


参数 列表 也 可 以 简化 : 编译 器 有 时 可 以 根据 lambda 表 达 式 转化 后 的 类型 
推 呆 参数 类 型 。lambda 表 达 却 本身 没有 类 型 ， 但 可 以 转换 为 兼容 的 委托 
类 型 ， 这 样 编译 占 束 可 以 依据 该 转换 来 推 师 参数 类 型 。 


在 前 面 的 代码 中 ， 编 译 器 知道 Action<string> 有 一 个 string 类 型 的 参 
数 。 根 据 这 一 信息 ， 就 可 以 推 新 出 lambda 表 达 式 的 参数 类 型 。 当 编译 器 
0 
简化 为 : 


Action<string> action = 

(message) => Console.WriteLine("In delegate: {0}", message); 
如 果 lambda 表 达 式 只 有 一 个 参数 ， 并 且 可 以 推断 出 参数 类 型 ， 那 么 参数 
列表 的 圆 括号 也 可 以 省 略 : 
Action<string> action = 

message => Console.WriteLine("In delegate: {0}", message); 
下 和 面 看 儿 个 含 return 语 句 的 例子 ， 并 且 把 每 个 例子 都 一 步 步 地 简化 。 首 
先 构建 一 个 委托 来 执行 两 整 型 相 乘 并 返回 结果 : 


Func<int，int，int> multiply = (本 行 及 以 下 1 行 ) 最 长 的 版 本 
(int x, int y) => { return x * y; }; 











Func<int, int, int> multiply = (int x, int y) => x * y; <------ 但 


Func<int, int, int> multiply = (x, y) => x * y; <------ 推断 参数 类 
(有 两 个 参数 ， 因 此 不 能 省 略 圆 括号 ) 





接着 再 创建 一 个 委托 ， 获 取 一 个 字符 串 的 长 度 ， 将 长 度 目 乘 ， 然 后 返回 
计算 结果 : 


Func<string, int> squareLength = (String text) => <------ 最 长 的 版 ; 


int length = text,Length ; 
return length * length; 


}; 
Func<string, int> squareLength = (text) => <------ 推断 参数 类 型 
int length = text.Length; 
return length * length; 
}; 
Func<string, int> squareLength = text => <------ 单 参 数 时 可 以 省 略 同 非 


int length = text.Length; 
return length * length; 


}; 

(目前 无 法 继续 简化 了 ， 因 为 主体 有 两 条 语句 ) 

也 可 以 通过 计算 两 次 Length 值 的 方式 ， 进 一 步 简 化 以 上 代码 : 
Func<string, int> squareLength = text => text.Length * text.Lengt 


当然 ， 这 属于 另 一 个 层面 的 简化 ， 它 通过 修改 代码 逻辑 来 实现 简化 ， 不 
是 语法 层面 的 简化 。 这 些 特殊 实例 虽然 看 起 来 比较 奇怪 ， 但 实际 上 这 样 
的 简化 适用 场景 相当 广 ， 尤 其 是 在 LINQ 中 。 人 至 此 ， 语 法 部 分 介绍 完 

毕 ， 下 面 继续 讲解 委托 实例 的 行为 模式 ， 尤 其 是 关于 变量 捕获 的 方面 。 














3.5.2 ”捕获 变量 


2.3.2 节 讲 匿 名 方法 捕获 变量 时 ， 说 过 要 在 lambda 表 达 式 中 重 提 这 一 话 
题 。 这 或 许 是 lambda 表 达 式 最 难 懂 的 一 部 分 ，Stack Overflow 上 面 有 很 
多 相关 问题 。 


要 通过 lambda 表 达 式 来 创建 委托 实例 ， 编 译 堪 需要 把 ljambda 表 达 式 中 的 
代码 转换 成 一 个 方法 ， 之 后 在 执行 期 创建 委托 束 如 同 已 经 定义 了 方法 组 
一 样 。 下 面 主 要 介绍 编译 堪 执 行 的 转换 过 程 。 这 样 描述 让 人 感觉 编译 堪 
需要 把 一 部 分 源码 转译 成 男 一 些 不 包含 lambda 表 达 式 的 源码 ， 但 实际 上 
编译 器 不 会 这 样 做 ， 它 可 以 直接 生成 相应 的 区 代码 。 








首先 简单 回顾 捕获 变量 的 概念 。 在 lambda 表 达 式 中 ， 可 以 像 使 用 普通 方 
法 那样 任意 使 用 变量 。 这 些 变量 可 以 是 静态 字段 、 实 例 字段 (如 果 在 实 
例 方 法 中 编写 lambda 表 达 式 1) 、this 变 量 、 方 法 参数 或 者 局 部 变量 。 

这 些 都 属于 捕获 变量 的 范畴 ， 因 为 它们 都 定义 在 lambda 表 达 式 所 在 直接 
上 下 文 之 外 。 那 些 lambda 表 达 式 目 带 的 参数 或 者 定义 在 lambda 表 达 式 内 
部 的 局 部 变量 ， 则 不 属于 捕获 变量 。 代 码 清 单 3-6 展 示 了 lambda 表 达 式 
捕获 的 各 种 变量 ， 之 后 会 讲解 编译 器 是 如 何 处 理 这 部 分 代码 的 。 


1 构造 器 、 属 性 访问 器 等 也 可 以 包含 lambda 表 达 式 ， 不 过 简单 起 见 ， 这 
里 假定 只 在 方法 中 使 用 lambda 表 达 式 。 


代码 清单 3-6 ”lambda 表 达 式 捕获 变量 


class CapturedVariablesDemo 


t 

















private string instanceField = "instance field"; 


public Action<string> CreateAction(string methodParameter ) 
{ 

string methodLocal = "method local"; 

string uncaptured = "uncaptured local"; 


Action<string> action = lambdaParameter => 

{ 
string lambdaLocal = "lambda local"; 
Console.writeLine("Instance field: {0}", instanceFiel 
Console.writeLine("Method parameter: {0}", methodPara 
Console.writeLine("Method local: {0}", methodLocal); 
Console.writeLine("Lambda parameter: {0}", lambdaPara 
Console.writeLine("Lambda local: {0}", lambdaLocal); 

}; 

methodLocal = "modified method local"; 

return action; 


} 
// 其 他 代码 
var demo = new CapturedVariablesDemo( ) ; 


Action<string> action = demo.CreateAction("method argument"); 
action("lambda argument"); 


其 中 涉及 很 多 变量 : 


instanceFie1ld 是 capturedvariablesDemo 类 的 一 个 实例 字段 ， 为 
lambda 表 达 式 所 捕获 ; 

methodParameter 是 CreateAction 方 法 的 一 个 参数 ， 为 ljambda 表 达 式 
所 捕获 ; 

methodLocal 是 createAction 方 法 中 的 一 个 局 部 变量 ， 为 lambda 表 达 
式 所 捕获 ; 

uncaptured 是 createAction 方 法 中 的 一 个 局 部 变量 ， 因 为 没有 被 
lambda 表 达 式 使 用 ， 所 以 不 属于 捕获 变量 ; 
lambdaParameter 是 lambda 表 达 式 目 己 的 参数 ， 不 属于 捕获 变量 ; 
lambdaLocal 是 lambda 表 达 式 内 部 的 局 部 变量 ， 不 属于 捕获 变量 。 


需要 重点 关注 的 是 ， 这 些 lambda 表 达 式 捕获 的 是 这 些 变量 本 身 ， 而 不 是 
委托 创建 时 这 些 变量 的 值 2。 如 果 在 委托 定义 后 到 委托 调用 前 这 一 期 间 
修改 任何 一 个 捕获 变量 ， 那 么 这 些 修 改 都 会 在 输出 结果 中 体现 出 来 。 同 
样 ，lambda 表 达 式 自己 也 能 够 修改 这 些 捕获 变量 的 值 ， 那 么 编译 器 如 何 
保证 这 些 变量 在 委托 调用 时 依然 可 用 呢 ? 


2 关于 这 一 点 ， 本 书 会 不 厌 其 烦 地 反复 强调 。 对 于 不 熟悉 捕获 变量 的 读 
者 ， 可 能 需要 一 些 时 间 来 适应 。 


1. 通过 生成 类 来 实现 捕获 变量 
考虑 如 下 3 种 普遍 情形 。 


o 如 果 没 有 捕获 任何 变量 ， 那 么 编译 器 可 以 创建 一 个 静态 方法 ， 
不 需要 额外 的 上 下 文 。 

如 果 仅 捕获 了 实例 字段 ， 那 么 编译 器 可 以 创建 一 个 实例 方法 。 
在 这 种 情况 下 ， 捕 获 1 个 实例 字段 和 捕获 100 个 没有 什么 差别 ， 
只 需 一 个 this 便 可 都 可 以 访问 到 。 

如 果 有 局 部 变量 或 参数 被 捕获 ， 编 译 器 会 创建 一 个 私有 的 般 套 
类 来 保存 上 下 文 信息 ， 然 后 在 当前 类 中 创建 一 个 实例 方法 来 容 
纳 原 lambda 表 达 式 的 内 容 。 原 先 包含 lambda 表 达 式 的 方法 会 被 
修改 为 使 用 骸 套 类 来 访问 捕获 变量 。 


具体 实现 细 市 因 编 译 絮 而 异 


读者 可 能 会 过 到 上 述 流 程 的 不 同 变 体 。 例 如 对 于 没有 捕获 变量 
的 lambda 表 达 式 ， 编 译 器 可 能 会 创建 一 个 包含 一 个 实例 方法 的 
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供 套 类 ， 而 不 是 创建 一 个 静态 方法 。 委 托 的 执行 效率 会 因 创建 
方式 的 不 同 而 略 有 差异 。 这 里 只 描述 编译 需 为 访问 捕获 变量 所 
锭 的 那些 必要 、 基 本 的 工作 ， 其 复杂 度 可 能 根据 实际 需要 而 增 
0H。 


显然 ， 最 后 一 种 情形 最 为 复杂 ， 因 此 需要 重点 关注 。 先 看 代码 清单 
3-6。 下 面 是 创建 lambda 表 达 式 的 方法 《其 中 寡 略 了 类 声明 部 


Ws 











public Action<string> CreateAction(string methodParameter ) 


{ 
string methodLocal = "method local"; 
string uncaptured = "uncaptured local"; 


Action<string> action = lambdaParameter => 

{ 
string lambdaLocal = "lambda local"; 
Console.writeLine("Instance field: {0}", instanceFiel 
Console.writeLine("Method parameter: {0}", methodPara 
Console.writeLine("Method local: {0}", methodLocal); 
Console.writeLine("Lambda parameter: {0}", lambdaPara 
Console.writeLine("Lambda local: {0}", lambdaLocal); 


/ 
methodLocal = "modified method local"; 
return action; 
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如 前 所 述 ， 编 译 器 会 创建 一 个 私有 的 花 套 类 来 保存 额外 的 上 下 文 信 
恩 ， 然 后 在 该 类 中 创建 一 个 实例 方法 用 于 容纳 lambda 表 达 式 的 代 
码 。 上 下 文 信息 被 保存 在 伦 套 类 的 实例 变量 中 ， 在 本 例 中 就 是 : 


o 一 个 capturedvariablespemo 类 实例 的 引用 ， 用 于 之 后 访问 
instanceField; 

o 一 个 string 变 量 来 保存 捕获 的 方法 参数 ; 

o 一 个 string 变 量 来 保存 捕获 的 局 部 变量 。 


下 面 是 和 藤 套 类 以 及 createAction 方 法 使 用 该 侍 套 类 的 代码 。 
代码 清单 3-7 捕获 变量 的 lambda 表 达 式 转译 后 的 代码 


private class LambdaContext <------ 生成 类 保存 捕获 变量 
{ 














public CapturedVvariablesDemoImp1 originalThis; (本 行 及 以 下 : 
public string methodParameter ; 
public string methodLocal 


public void Method(string lambdaParameter) <------ lambda 


{ 


string lambdaLocal = "lambda local"; 
Console.writeLine("Instance field: {0}", 
originalThis.instanceField); 
Console.writeLine("Method parameter: {0}", methodPara 
Console.writeLine("Method local: {0}", methodLocal); 
Console.writeLine("Lambda parameter: {0}", lambdaPara 
Console.writeLine("Lambda local: {0}", lambdaLocal); 


} 


public Action<string> CreateAction(string methodParameter ) 


{ 
LambdaContext context = new LambdaContext(); (本 行 及 以 下 7 行 
context.originalThis = this,; 
context .methodParameter = methodParameter; 
context .methodLocal = "method local"; 
string uncaptured = "uncaptured local"; 


Action<string> action = context.Method; 
context.methodLocal = "modified method local"; 
return action， 


} 


注意 createAction 方 法 末尾 附近 的 context .methodLocal 是 如 何 被 修 
改 的 。 当 委托 最 终 被 执行 时 ， 它 能 够 知道 该 变量 的 修改 情况 。 同 

样 ， 如 果 委 托 自 己 修改 了 任何 捕获 的 变量 ， 那 么 每 个 委托 的 调用 都 
会 受到 前 一 个 调用 的 影响 。 再 次 强调 : 编译 颖 捕获 的 是 变量 本 号 ， 
而 不 是 变量 值 的 副本 。 

以 上 两 个 代码 示例 中 为 捕获 变量 仅 创 建 了 一 个 上 下 文 。 根 据 编程 规 
人 每 个 局 部 变量 只 能 有 一 次 实例 化 。 下 面 丰 富 一 下 这 个 示 
列 。 


























. 局 部 变量 的 多 次 实例 化 


简单 起 见 ， 这 次 不 捕获 参数 和 实例 字段 ， 只 捕获 一 个 局 部 变量 。 请 
看 代码 清单 3-8: 在 createActions 方 法 中 创建 了 action 的 一 个 list， 


然后 依次 执行 这 些 action， 其 中 每 个 action 都 会 捕获 text 变 量 。 
代码 清单 3-8 局 部 变量 的 多 次 实例 化 


static List<Action> CreateActions() 








List<Action> actions = new List<Action>(); 
for (int i = 0; i < 5; i++) 
string text = string.Format("message {0}", i); <----- 


actions.Add(() => Console.WriteLine(text)); <------ 丰 


} 
return actions,; 
// 其 他 代码 


List<Action> actions = CreateActions(); 
foreach (Action action in actions) 


action( ); 





在 这 段 代码 中 ，text 在 循环 中 声明 是 非常 关键 的 一 点 。 每 次 声 

明 text 时 ， 该 变量 就 完成 一 次 实例 化 ， 因 此 每 个 lambda 表 达 式 捕获 
的 都 是 不 同 的 变量 实例 ， 于 是 5 个 完全 独立 的 text 变 量 被 分 别 捕 
获 。 虽 然 这 段 代码 中 变量 初始 化 后 没有 任何 修改 操作 ， 但 实际 上 我 
们 完全 可 以 在 循环 内 部 或 在 lambda 表 达 式 内 部 修改 该 变量 的 值 。 无 
论 修改 哪个 变量 值 ， 都 不 会 影响 其 他 变量 。 


编译 器 的 做 法 是 : 每 次 初始 化 都 创建 一 个 不 同 的 生成 类 型 实例 ， 因 
此 代码 清单 3-8 中 的 createAction 方 法 会 转译 成 如 下 形式 。 


代码 清单 3-9 ”为 每 次 初始 化 创建 上 下 文 实 例 


private class LambdaContext 








public string text; 
public void Method() 


Console.WriteLine(text); 


static List<Action> CreateActions() 
List<Action> actions = new List<Action>(); 
for (int i = 0; i < 5; i++) 


LambdaContext context = new LambdaContext(); <------ 
context.text = string.Format("message {0}", 1); 
actions.Add(context.Method); <------ 使 用 上 下 文 创建 一 个 a 





上 


return actions,; 


} 
希望 读者 理解 这 段 代 码 。 我 们 是 从 lambda 表 达 式 的 单一 上 下 文 ， 进 
阶 到 了 循环 的 每 次 迭代 都 有 一 个 新 的 上 下 文 。 接 下 来 继续 增加 复杂 
上 度 ， 把 这 两 种 情况 混在 一 起 。 





. 多 个 作用 域 下 的 变量 捕获 


循环 的 每 次 迭代 都 要 实例 化 一 次 变量 ， 是 因为 变量 作用 域 的 缘故 。 
一 个 方法 内 部 可 能 存在 多 个 作用 域 ， 每 个 作用 域 都 可 能 包含 局 部 变 
量 的 声明 ， 而 一 个 lambda 表 达 式 可 以 从 多 个 作用 域 捕获 变量 ， 示 例 
见 代码 清单 3-10。 这 段 代 码 创建 了 两 个 委托 实例 ， 每 个 委托 分 别 捕 
获 两 个 变量 : 它们 捕获 同一 个 outercounter 变 量 ， 又 各 目 捕 获 一 

个 innercounter 变 量 。 委 托 的 工作 束 是 打印 变量 的 当前 值 ， 并 且 执 
行 加 一 操作 。 最 后 将 每 个 委托 各 自 执 行 两 次 ， 这 样 可 以 清楚 地 展现 
捕获 变量 之 间 的 区 别 。 


代码 清单 3-10 ”从 多 个 作用 域 捕获 变量 


static List<Action> CreateCountingActions() 


























List<Action> actions = new List<Action>(); 





int outerCounter = 0; <------ 两 个 委托 捕获 同一 个 变量 
for (int i = 0; i < 2; I++) 
int innerCounter = 0; <------ 每 次 循环 都 创建 一 个 新 变量 








Action action = () => 


Console .WriteLine( (本 行 及 以 下 4 行 ) 计数 器 打印 和 自 增 
"Outer: {0}; Inner: {1}", 
outerCounter, innerCounter); 





OuterCounter++， 
InnerCounter++， 
】 


actions.Add(action); 


return actions,; 


} 
// 其 他 代码 


List<Action> actions = CreateCountingActions(); 
actions[90](); (本 行 及 以 下 3 行 ) 每 个 委托 调用 两 次 
actions[0](); 

actions[1](); 

actions[1](); 


代码 清单 3-10 的 执行 结果 如 下 : 





Outer: 0; Inner: 0 
Outer: 1; Inner: 1 
Outer: 2; Inner: 0 
Outer: 3; Inner: 1 


前 两 行 是 第 1 个 委托 打印 的 结果 ， 后 两 行 是 第 2 个 委托 打印 的 结 
如 前 所 述 ，outercounter 变 量 被 两 个 委托 共用 ， 而 innercounter 为 
两 个 委托 分 别 所 有 。 


每 个 委托 都 需要 各 自 的 上 下 文 ， 但 是 各 自 的 上 下 文 还 需要 指 癌 一 个 
公共 的 上 下 文 。 编 译 器 是 如 何 处 理 这 种 情况 的 呢 ? 答案 是 创建 两 个 
私有 骸 套 类 。 代 码 清单 3-10 经 编译 器 处 理 后 的 结果 如 下 。 
代码 清单 3-11 从 多 个 作用 域 捕获 变量 而 创建 多 个 类 


private class OuterContext (本 行 及 以 下 3 行 ) 外 层 作用 域 的 上 下 文 











public int outerCounter; 


} 


private class InnerContext (本 行 及 以 下 3 行 ) 包含 外 层 上 下 文 引 用 的 内 层 
{ 





public OuterContext outerContext; 
public int innerCounter; 








public void Method() <------ 用 于 创建 委托 的 方法 
{ 


Console,.WriteLine( 
"Outer: {0}; Inner: {1}", 
outerContext.outerCounter, innerCounter); 
outerContext .outerCounter++; 


innerCounter+t++; 
} 
static List<Action> CreateCountingActions() 
{ 
List<Action> actions = new List<Action>(); 
OuterContext outerContext = new OuterContext(); <------ 他 
outerContext .outerCounter = 0; 
for (int i = 0; i < 2; i++) 
{ 
InnerContext innerContext = new InnerContext(); (本 行 ) 
innerContext.outerContext = outerContext; 
innerContext. annercounter = 0; 
Action action = innerContext.Method; 
actions.Add(action); 
} 
return actions,; 
} 


大 多 数 读者 很 少 需要 查看 这 样 的 代码 ， 但 编译 器 生成 代码 的 方式 会 
对 程序 性 能 有 不 小 的 影响 。 如 果 在 性 能 敏感 的 代码 中 使 用 lambda 表 
达 式 ， 那 么 天 要 注意 可 能 会 因为 变革 区 而 创建 过 多 对 象 ， 从 而 
响 性 能 


关于 同一 作用 域 下 多 个 lambda 表 达 式 捕获 不 同 的 变量 集合 ， 或 者 在 
值 类 型 方法 中 使 用 lambda 表 达 式 ， 还 有 很 多 示例 可 举 。 虽 然 我 认为 
研究 编译 器 生成 的 代码 这 件 事 很 有 趣 ， 但 恐怕 读者 不 这 么 想 。 奉 有 
兴趣 了 解 编译 器 处 理 lambda 表 达 式 的 机 制 ， 只 需要 运行 ijdasm 之 类 
的 有 反 编 译 器 即 可 。 

前 面 介绍 了 如 何 把 lambda 表 达 式 转换 成 委托 ， 而 使 用 匿名 方法 也 能 
Rs 
对 。 











3.5.3 “表达 式 树 
表达 式 树 是 将 代码 按照 数据 来 表示 的 一 种 形式 。 这 项 特性 是 LINQ 能 够 





有 效 处 理 SQL 数 据 库 这 类 数据 提供 者 的 核心 秘诀 所 在 。 通 过 表达 式 树 ， 
C# 的 代码 可 以 在 执行 期 被 分 析 并 转换 成 SQL。 


委托 的 作用 是 提供 可 运行 的 代码 ， 而 表达 式 树 的 作用 是 提供 可 查看 的 代 
人 码 ， 这 有 点 类 似 于 反映 (reflection〉 机 制 。 虽 然 也 可 以 在 代码 中 直接 构 
建 表达 式 树 ， 但 更 普 裔 的 做 法 是 让 编译 器 负责 把 lambda 表 达 式 转换 成 表 
达 式 树 。 代 码 清单 3-12 通 过 创建 一 个 表达 式 树 完 成 两 个 值 的 相 加 操作 。 


代码 清单 3-12 ”表达 式 树 一 一 两 个 整 型 值 相 加 


Expression<Func<int, int, int>> adder = (x, y) => x + y; 
Console.writeLine(adder); 


里 然 只 有 短 短 两 行 代码 ， 但 其 背后 发 生 了 很 多 事情 。 先 从 结果 看 起 。 如 
果 打 印 一 个 普通 的 委托 ， 所 得 结果 只 是 一 个 关于 类 型 的 结果 ， 不 会 包含 
任何 委托 行为 的 信息 ， 而 代码 清单 3-12 准 确 地 描述 了 表达 式 树 的 行为 : 


(x, y) => X + y 


编译 器 并 未 在 任何 地 方 生成 一 个 便 编 码 的 字符 串 。 以 上 字符 串 是 通过 表 
达 陈 树 动态 构建 出 来 的 。 这 段 代 码 表 明 : 代码 是 可 以 进行 执行 期 检查 
的 。 这 惑 是 表达 式 树 的 所 有 关键 所 在 。 


首先 看 adder 的 类 型 : Expression<Func<int，int，int>>。 把 它 拆 解 成 
两 部 分 : Expression<TDelegate> 和 Func<int， int, int>。 第 2 部 分 是 第 1 
部 分 的 类 型 实 参 ， 它 是 一 个 代理 类 型 ， 由 两 个 int 参 数 和 一 个 int 人 返回 值 
构成 。《〈 返 回 值 类 型 由 最 后 一 个 参数 指定 ， 例 如 Func<string，double， 
int> 的 意思 是 接收 string 和 double 类 型 的 参数 ， 返 回 int 类 型 值 。) 


Expression<TDelegate> 是 处 理 TDelegate 类 型 的 表达 式 树 类 型 。 其 中 
TDelegate 必 须 是 委托 类 型 〈 不 是 通过 类 型 约束 体现 的 ， 而 是 在 执行 期 
强制 保证 的 ) 。 委 托 类 型 仅仅 是 表达 式 树 相关 的 诸多 类 型 之 一 ， 它 们 均 
位 于 system.Linq.Expressions 命 名 空间 下 。 非 泛 型 的 Expression 类 是 所 
0 它 也 用 于 容纳 创建 具象 子 类 实例 的 工厂 方 
二 8 


adder 变 量 是 一 个 表示 接收 两 个 整 型 值 并 返回 一 个 整 型 值 方法 的 表达 陈 


树 表 示 ， 之 后 可 以 用 lambda 表 达 式 来 为 该 变量 赋值 。 编 译 才 负 责 生成 适 
用 于 执行 期 的 表达 式 树 。 示 例 代 码 相对 简单 (读者 也 可 以 自行 手动 实 





























现 ) 。 
代码 清单 3-13 手动 创建 表达 式 树 一 一 两 个 整 型 值 相 加 


ParameterExpression xParameter = Expression.Parameter(typeof(int) 
ParameterExpression yParameter = Expression.Parameter(typeof(int) 
Expression body = Expression.Add(xParameter, yParameter); 

ParameterExpression[|] parameters = new[|] { xParameter, yParameter 


Expression<Func<int, int, int>> adder = 
Expression.Lambda<Func<int, int, int>>(body, parameters); 
Console.writeLine(adder ); 


虽然 示例 比较 简单 ， 但 仍 比 lambda 表 达 式 复杂 多 了 。 在 添加 了 方法 调 
用 、 属 性 访问 器 、 对 象 初始 化 器 这 些 之 后 ， 就 会 变 得 更 复杂 且 更 易 出 
错 ， 因 此 能 让 编译 堪 负 和 贡 把 lambda 表 达 式 转换 成 表达 式 树 特别 重要 ， 不 
过 关于 此 还 有 一 些 限制 规则 。 


1. 转换 表达 式 树 的 局 限 性 


只 有 拥有 表达 式 主体 的 lambda 表 达 式 才能 转换 成 表达 式 树 ， 这 条 规 
a 
民 铬 : 


Expression<Func<int, int, int>> adder = (x, y) => { return x 


从 .NET 3.5 开 始 ， 表 达 式 树 API 束 已 经 扩展 支持 代码 块 和 其 他 构建 
了 ， 但 是 C# 编 译 器 依然 保留 了 该 限制 ， 而 且 对 于 LINQ 使 用 的 表达 
式 树 也 有 同样 的 限制 。 这 也 是 对 象 初始 化 器 和 集合 初始 化 器 很 重要 
的 原因 : 可 以 在 一 个 表达 式 内 完成 初始 化 ， 以 供 表 达 式 树 使 用 。 


另外 ，lambda 表 达 式 不 能 使 用 赋值 运算 符 ， 也 不 能 使 用 C# 4 的 动态 
类 型 和 C# 5 的 异步 。《 虽 然 对 象 初 始 化 右 和 集合 初始 化 器 也 用 到 了 
=， 但 是 在 其 上 下 文中 并 不 算 赋 值 运算 符 。) 


























2. 将 表达 式 树 编译 成 委托 


如 前 所 述 ， 对 远程 数据 源 执行 得 询 操作 并 不 是 表达 式 树 的 唯一 用 
途 。 表 达 式 树 可 用 于 在 执行 期 动态 构建 委托 ， 虽 然 这 种 方式 一 般 需 





要 手动 编写 部 分 代码 ， 而 不 是 使 用 lambda 表 达 式 进行 转化 。 


Expression<TDelegate> 有 一 个 Compile() 方 法 ， 访 方法 返回 一 个 委 
托 类 型 。 该 委托 类 型 与 普通 的 委托 类 型 无 异 。 借 用 前 面 那个 例子 ， 
我 们 构建 出 adder 表 达 式 树 ， 将 其 编译 成 一 个 委托 ， 然 后 调用 该 委 
托 并 打印 出 结果 5。 


代码 清单 3-14 ”把 表达 却 树 编译 成 委托 ， 并 调用 委托 得 到 结 


Expression<Func<int, int, int>> adder = (x, y) => x + y; 
Func<int, int, int> executableAdder = adder.Compile(); <----- 
Console.WriteLine(executableAdder(2, 3)); <------ 正常 调用 委托 


这 项 能 力 可 以 和 反射 特性 搭配 使 用 ， 用 于 访问 属性 、 调 用 方法 来 生 
成 并 缓存 委托 ， 其 结果 与 手动 编写 委托 结果 相同 。 对 于 单一 的 方法 
调用 或 访问 属性 ， 已 经 存在 现 有 的 方法 来 直接 创建 委托 ， 不 过 有 时 
和 


等 到 介绍 完 所 有 相关 特性 之 后 ， 我 们 再 回头 讨论 为 什么 表达 式 树 对 
于 LINQ 如 此 重要 。 至 此 ， 还 剩 最 后 两 个 特性 未 介绍 ， 其 一 是 扩展 
方法 。 
3.6 ”扩展 方法 
扩展 方法 是 一 个 静态 方法 ， 它 可 以 在 其 第 一 个 参数 的 类 型 实例 上 以 实例 
方法 的 调用 方式 进行 调用 。 这 个 特性 乍 听 起 来 似乎 没什么 意义 。 假 设 有 
如 下 方法 调用 : 


ExampleClass.Method(x, y); 

















把 Exampleclass.Method 改 成 扩展 方法 之 后 ， 束 可 以 这 样 调用 了 : 


X,Method(y ) ; 


以 上 就 是 扩展 方法 的 全 部 内 容 。 扩 展 方法 是 C# 编 译 占 最 简单 的 转换 工作 
之 一 。 当 对 扩展 方法 进行 链 式 调用 时 ， 它 能 显著 增强 代码 的 可 读 性 。 关 
于 可 该 性 的 增强 ， 后 面 介 绍 LINQ 示 例 时 还 会 看 到 ， 下 面 先 讲解 其 语 
0 











3.6.1 声明 扩展 方法 


声明 扩展 方法 时 ， 需 要 在 其 第 一 个 参数 前 添加 关键 字 this。 扩 展 方法 必 
质 声 明 在 一 个 非 江 家 ， 泛 型 的 静态 类 中 ， 而 且 在 Ch 7.2 之 前 第 一 个 参 
数 不 能 是 ref 参 数 〔13.5 节 会 详 述 ) 。 扩 展 方法 所 在 的 类 不 能 是 泛 型 类 
但 扩展 方法 自身 可 以 是 泛 型 方法 。 


扩展 方法 的 第 一 个 参数 有 时 称 为 扩展 目标 〈target) 或 扩展 类 型 
Cextended type) 《〈C# 编 程 规范 中 并 没有 给 出 官方 命名 ) 。 


这 里 借用 Noda Time 的 一 个 例子 : 有 一 个 扩展 方法 ， 它 负责 把 
DateTimeoffset 类 型 值 转换 为 Instant 类 型 值 。 在 Instant 吉 构 体 中 ， 目 
前 已 有 一 个 静态 方法 来 完成 这 项 工作 ， 但 还 需要 再 添加 一 个 扩展 方法 。 
代码 清单 3-15 是 该 方法 的 实现 。 这 里 引入 了 命名 空间 的 声明 〈 仅 此 一 
次 ) 。 后 面 介 绍 C# 编 译 器 如 何 碍 找 扩 展 方 法 时 ， 还 会 用 到 该 命名 空间 。 


代码 清单 3-15” Noda Time 中 的 ToInstant 扩 展 方法 

















using System; 
namespace NodaTime.Extensions 
public static class DateTimeoffsetExtensions 
public static Instant ToInstant(this DateTimeoffset dateT 


return Instant.FromDateTimeOffset(dateTimeOffset); 


} 


编译 器 唯一 需要 做 的 就 是 为 扩 展 方法 及 其 所 在 类 添加 [Extension] 特 
性 o 该 特性 在 命名 空 | 本 System Runtime. compilerServices 下 。 它 本 质 上 


是 一 个 标记 ， 标 记 ToInstant() 方 法 可 以 按照 bpateTimeoffset 的 实例 方法 
那样 调用 。 


3.6.2 ”调用 扩展 方法 


前 文 展示 过 扩展 方法 的 调用 : 扩展 方法 可 以 在 其 第 一 个 参数 的 类 型 实例 
上 以 实例 方法 的 调用 方式 进行 调用 ， 但 还 需要 一 个 前 提 ， 就 是 让 编译 器 











可 以 碍 找到 这 个 扩展 方法 。 


首先 是 优先 级 问题 : 如 果 存 在 一 个 与 该 类 同名 的 普通 实例 方法 ， 那 么 编 
译 器 总 是 会 优先 选择 该 实例 方法 来 调用 。 在 此 过 程 中 ， 无 所 谓 扩展 方法 
征 售 具 有 更 匹配 的 形 参 。 如 果 编 译 圳 查找 到 有 可 调用 的 实例 方法 ， 惑 不 
会 再 去 得 找 扩展 方法 了 。 


如 果 编 译 器 没有 找到 可 调用 的 实例 方法 ， 那 么 会 开始 查找 扩展 方法 。 首 
先 查 找 扩展 方法 调用 代码 所 在 的 命名 空间 以 及 所 有 using 指 令 指 定 的 命 
名 空间 。 现 在 假设 在 csharpInDepth.chapter03 这 个 命名 空间 中 调 

用 ExtensionMethodInvocation 类 的 扩展 方法 3， 参 考 代码 清单 3-16〔 假 
设 编译 堪 拥 有 足够 的 信息 来 查找 到 扩展 方法 ) 。 

3 如 果 读 者 查看 随 书 代码 ， 会 发 现 其 中 所 有 命名 空间 都 是 Chapter01、 
Chapter02 这 样 的 简单 形式 。 这 里 没有 采用 简单 形式 ， 则 在 展示 编译 器 但 
找 命名 空间 时 的 层次 特点 。 


代码 清单 3-16 ”在 Noda Time 之 外 调用 ToInstant() 扩 展 方法 














using NodaTime.Extensions; <------ 引入 NodaTime .Extensions 命 名 空间 
using System; 


namespace CSharpInDepth.chapter03 
class ExtensionMethodInvocation 
static void Main() 


var currentInstant = 
DateTimeOffset.UtcNow.ToInstant(); <------ 调用 扩 哲 
Console.writeLine(currentIinstant); 
} 
} 
} 


编译 器 会 从 以 下 位 置 碍 找 扩展 方法 : 


e。 CSharpInDepth.chapter03 命 名 空间 下 的 静态 类 ; 

。 CSharpInDepth 命 名 空间 下 的 静态 类 ; 

。 全 局 命名 空间 下 的 静态 类 ; 

。 using 指 令 指 定 的 命名 空间 下 的 静态 类 【例如 using system 这 样 的 指 


问 命 名 空间 的 命令 ) ; 
。 (只 在 C# 6 中 ) using static 指 定 的 静态 类 ，10.1 节 还 会 介绍 。 


编译 器 会 从 最 内 层 的 命名 空间 一 路 问 外 俘 找 至 全 局 命名 空间 。 在 会 找 的 
每 条 路 入 上 ， 痢 要 低 找 当前 命名 空间 下 的 静态 类 ， 或 者 查找 using 指 令 
指定 的 命名 空间 中 的 类 。 低 找 的 顺序 并 不 重要 。 如 果 调 整 using 指 令 的 
顺序 后 影响 了 扩展 方法 的 查找 结 采 ， 建 议 将 扩展 方法 重新 命名 。 不 过 需 
要 知道 ， 得 找 的 每 一 步 中 都 有 可 能 找到 多 个 适合 调用 的 扩展 方法 。 此 时 
编译 器 会 对 当前 所 有 候选 方法 执行 常规 的 重 载 决议 。 在 诀 策 完成 后 ， 编 
译 恬 为 调用 扩展 方法 所 生成 的 苇 代 码 和 调用 普通 静态 方法 所 生成 的 开 代 
码 是 完全 相同 的 。 


nul1 值 也 可 以 调用 扩展 方法 


在 处 理 nul1 值 的 问题 上 ， 扩 展 方法 和 实例 方法 有 所 不 同 。 请 看 最 初 
的 那个 例子 : 


x.Method(y); 


如 果 Method 是 实例 方法 ，x 为 nul1， 就 会 抛 出 一 

个 NullReferenceException; 而 如 果 Method 是 一 个 扩展 方法 ， 那 么 
即便 x 为 nul1， 也 会 将 x 作 为 其 首 个 参数 进行 方法 调用 。 有 时 扩展 方 
法 会 要 求 参 数 不 能 为 nu1l1， 当 参数 为 nul1 时 则 应 抛 出 
ArgumentNullException。 或 者 扩展 方法 已 经 过 精心 设计 ， 可 以 妥善 
处 理 null。 


下 面 回 过 头 看 看 为 什么 扩展 方法 对 于 LINQ 意 义 非 几 。 这 就 要 谈 及 俘 询 


语句 了 

3.6.3 扩展 方法 的 链 式 调用 

代码 清单 3-17 是 一 个 简单 查询 : 现 有 一 个 单词 序列 ， 我 们 需要 按照 单词 
长 度 进行 般 选 ， 并 将 其 按 字 母 顺 序 排 序 ， 然 后 全 部 转换 为 大 写 。 该 查询 
只 用 到 了 C# 3 中 的 lambda 表 达 式 和 扩展 方法 这 两 个 特性 。 本 章 最 后 会 把 
C# 3 的 所 有 特性 贯通 ， 这 里 重点 关注 这 一 小 段 代 码 的 可 读 性 。 


代码 清单 3-17 ”字符 串 简 单 查 询 
































string[] words = { "keys", "coat", "laptop", "bottle" }; <------ 
IEnumerable<string> query = words 
.Where(word => word.Length > 4) (本 行 及 以 下 2 行 ) 过 滤 、 排 序 、 转 换 
.OrderBy(word => word) 
.Select(word => word.ToUpper()); 





foreach (string word in query) (本 行 及 以 下 3 行 ) 打印 结果 


Console.WriteLine(word); 


} 


请 注意 ， 以 上 代码 中 where、orderBy 和 select 三 个 调用 的 顺序 就 是 操作 
实际 发 生 的 顺序 。 由 于 LINQ 中 存在 延迟 和 优化 策略 ， 我 们 很 难 知 道 共 
体 何 时 会 执行 什么 操作 ， 但 代码 的 阅读 顺序 和 执行 顺序 是 一 致 的 。 代 码 
清单 3-18 实 现 了 相同 的 查询 功能 ， 但 没有 使 用 扩展 方法 。 


代码 清单 3-18 没有 使 用 扩展 方法 的 简单 查询 


String[] words = { "keys", "coat", "laptop", "bottle" }; 
IEnumerable<string> query = 
Enumerable.Select( 
Enumerable.OrderBy( 
Enumerable.where(words, word => word.Length > 4), 
word => word), 
word => word.ToUpper()); 


里 然 我 努力 排版 ， 试 图 增强 以 上 代码 的 可 读 性 ， 但 阅读 起 来 依然 很 困 
难 。 代 码 中 方法 调用 的 顺序 和 实际 执行 的 顺序 刚好 相反 : where 方 法 是 
第 一 个 被 调用 的 ， 却 放 在 了 末尾 。 而 且 lambda 表 达 式 word => 
word.Toupper() 究 竟 属 于 哪个 方法 调用 很 不 明确 。 它 本 属于 select 方 
法 ， 但 和 select 中 间 隅 了 一 堆 代 码 。 


还 有 一 个 办 法 可 以 增强 以 上 代码 的 可 读 性 ， 那 就 是 把 每 个 方法 调用 的 结 
果 都 赋 给 一 个 局 部 变量 ， 然 后 通过 上 一 个 变量 再 继续 调用 下 一 个 方法 。 
请 看 代码 清单 3-19。 在 这 个 例子 中 ， 还 可 以 先 声 明 query 和 变量， 然后 
对 每 个 调用 的 结果 都 重新 赋值 ， 不 过 这 个 办 法 不 具有 普 适 性 。) 方便 起 
见 ， 这 次 还 是 使 用 var 来 声明 变量 。 


代码 清单 3-19 ”使 用 多 条 语句 实现 的 简单 查询 功能 








String[] words = { "keys", "coat", "laptop", "bottle" }; 
var tmp1 = Enumerable.where(words, word => word.Length > 4); 


var tmp2 = Enumerable.orderBy(tmp1，word => word ) ; 
var query = Enumerable.Select(tmp2, word => word.ToUpper()); 


这 段 代 码 比 代码 清单 3-18 要 好 些 。 操 作 的 顺序 回归 正常 ，lambda 表 达 式 
Wt 
散 注 意 力 。 


当然 ， 方 法 的 链 式 调用 带 来 的 好 处 不 仅仅 限于 LINQ。 一 个 方法 调用 的 

结果 用 作 男 一 个 方法 调用 的 开始 ， 类 似 的 需求 很 常见 ， 而 扩展 方法 能 让 
我 们 以 可 读 性 强 的 方式 编码 任何 类 型 ， 而 且 不 局 限于 那些 已 经 支持 链 式 
调用 的 类 型 。IEnumerable<T> 并 不 关心 与 LINQ 相 关 的 任何 内 容 ， 它 只 用 
于 表示 一 个 通用 序列 。 是 System.Lingq.Enumerable 类 添加 filter、group 
和 join 这 些 操 作 进 来 。 


C# 3 的 特性 本 可 以 到 此 为 止 了 。 现 有 的 特性 已 经 为 C# 语 言 注入 了 大 量 活 
力 ， 也 使 得 诸多 LINQ 碍 询 的 编写 方式 在 可 读 性 方面 近乎 完美 ， 但 是 当 
查询 变 得 更 复杂 ， 尤 其 是 增加 了 join 和 group 操 作 之 后 ， 直 接 使 用 扩展 
方法 会 变 得 十 分 复杂 ， 于 是 还 需要 一 个 新 的 特性 一 一 得 询 表达 式 。 


3.7 查询 表达 式 


虽然 几乎 C# 3 的 所 有 特性 都 对 LINQ 有 所 页 献 ， 但 只 有 查询 表达 式 是 专 
门 为 LINQ 设 计 的 。 使 用 查询 表达 式 ， 我 们 可 以 通过 查询 专用 语句 
(select、where、let、group by 等 ) 编写 简洁 的 查询 代码 。 由 编译 器 
负责 把 查询 表达 式 翻 译 成 非 查 询 语句 的 形式 ， 并 进行 常规 编译 4。 下 面 
举 一 个 人 简单 的 例子 。 还 记得 代码 清单 3-17 中 的 查询 语句 吗 ? 


4 该 机 制 听 起 来 类 似 于 C 语 言 中 的 宏 ， 不 过 查询 表达 式 比 宏 的 内 容 更 多 。 
C# 至 今 还 没有 宏 的 概念 。 
IEnumerable<string> query = words 

.Where(word => word.Length > 4) 


.OrderBy(word => word) 
.Select(word => word.ToUpper()); 


使 用 查询 表达 式 改 写 的 功能 相同 的 查询 代码 如 下 所 示 。 
代码 清单 3-20 ”使 用 filter、order、projection 的 查询 表达 式 入 门 












































IEnumerable<string> query = from word in words 
where word.Length > 4 
orderby word 
select word.ToUpper(); 


其 中 加 粗 的 部 分 就 是 查询 表达 式 了 ， 非 营 简 洁 。 之 前 word 在 lambda 表 达 
式 中 作为 参数 出 现 ， 而 在 碍 询 表达 式 中 word 在 from 子 句 中 作为 一 个 范围 
变量 出 现 ， 并 且 可 以 应 用 于 之 后 的 其 他 子 名 。 那 么 这 个 碍 询 表达 式 会 被 
怎么 处 理 呢 ? 


3.7.1 ”从 C# 到 C# 的 查询 表达 式 转 换 


前 面 很 多 特性 是 通过 转译 后 的 C# 源 码 来 讲解 的 ， 例 如 3.5.2 节 中 的 捕获 变 
量 ， 当 时 谈 到 了 如 果 要 实现 与 lambda 表 达 式 相同 的 效果 ， 需 要 编写 怎样 
的 C# 代 码 。 这 么 做 是 为 了 展示 编译 器 生成 代码 的 原理 ， 实 际 上 编译 器 并 
不 会 生成 任何 形式 的 C# 代 码 。C# 语 言 规范 中 对 于 捕获 变量 的 内 容 也 是 
在 描述 其 结果 ， 而 没有 定义 应 当 如 何 转 译 代码 。 


但 查询 表达 式 与 之 不 同 。 语 言 规范 直接 将 其 定义 为 一 种 语法 转译 ， 且 该 
转译 过 程 发 生 在 绑 定 或 重 载 决 议 之 前 。 代 码 清单 3-20 和 代码 清单 3-17 并 
不 仅仅 是 最 终结 果 一 致 ， 代 码 清单 3-20 在 进一步 处 理 之 前 就 会 被 转译 成 
代码 清单 3-17 的 形式 。 语 言 规范 中 没有 规定 下 一 步 处 理 的 处 理 形 式 。 很 
多 时 候 ， 转 译 的 结果 就 是 使 其 变 成 扩展 方法 的 调用 ， 不 过 语言 规范 并 没 
有 强制 要 求 该 行为 。 转 译 的 结果 也 可 以 是 实例 方法 的 调用 ， 或 者 

是 select、Wwhere 这 些 属性 返回 的 委托 的 调用 。 


关于 查询 表达 式 ，C# 语 言 规 范 中 规定 了 必须 提供 某 些 方法 ， 但 并 没有 要 
求 提 供 全 部 方法 。 例 如 对 于 一 个 包含 Select、orderBy 和 where 这 些 方法 
的 API， 我 们 可 以 使 用 像 代码 清单 3-20 中 那样 的 查询 语句 ， 但 没有 join 
子 句 可 以 使 用 。 


这 里 不 会 具体 讲解 每 个 查询 表达 式 子 句 ， 但 是 需要 重点 介绍 两 个 相关 概 
念 。 从 东 种 程度 上 说 ， 这 两 个 概念 是 引入 碍 询 表 达 式 更 为 重要 的 原因 。 


3.7.2 ”范围 变量 和 隐形 标识 符 


查询 表达 式 引 入 了 范围 变量 的 概念 。 范 围 变量 与 普通 变量 不 同 ， 范 围 变 
量 充当 了 但 询 语句 中 每 条 子 句 中 的 输入 。 在 上 一 个 例子 中 ， 位 于 查询 表 












































达 式 起 始 位 置 的 from 子 句 引 入 了 范围 变量 (加 粗 的 部 分 〉: 


from word in words <------ from 子 句 引 入 范围 变量 
where word.Length > 4 (本 行 及 以 下 2 行 ) 后 续 子 句 中 使 用 范围 变量 
orderby word 

select word.ToUpper() 


当 仅 存在 一 个 范围 变量 时 ， 比 较 好 理解 。 开 头 的 from 语 句 并 不 是 引入 范 
围 变 量 的 唯一 方式 。 子 句 中 引入 范围 变量 的 最 简单 方式 应 该 是 使 用 let 
关键 字 。 假 设 需要 在 查询 中 多 次 使 用 单词 长 度 这 个 变量 ， 但 我 们 又 不 想 
每 次 都 调用 Length 必 性。 如 果 需 要 就 单词 长 度 进行 排序 ， 并 且 在 输出 结 
果 中 使 用 长 度 变 量 ， 那 么 使 用 1et 子 句 的 查询 如 下 所 示 。 


代码 清单 3-21 使 用 1et 子 句 引 入 新 的 范围 变量 


from word in words 

let length = word.Length 

where length > 4 

orderby length 

select string.Format("{0}: {1}", length, word.ToUpper()); 


现在 作用 域 中 同时 有 两 个 范围 变量 : length 和 word。 那 么 问题 来 了 ， 在 
对 查询 进行 转译 时 ， 该 如 何 表 示 这 两 个 变量 呢 ? 这 就 需要 把 原始 的 单词 
序列 转换 成 “单词 -长 度 ” 对 。 在 需要 访问 范围 变量 的 子 句 中 ， 再 通过 变 
量 对 来 访问 其 中 的 某 个 变量 。 代 码 清单 3-22 展 示 了 代码 清单 3-21 经 过 编 
译 器 转译 后 如 何以 匿名 类 型 的 方式 表示 变量 对 。 


代码 清单 3-22 ”使 用 隐形 标识 符 对 查询 进行 转译 


words.Select(word => new { word, length = word.Length }) 
.Where(tmp => tmp.length > 4) 
.OrderBy(tmp => tmp.1length) 
.Select(tmp => 
string.Format("{0}: {1}", tmp.length, tmp.word.ToUpper() 


这 里 的 tmp 不 属于 查询 转译 的 一 部 分 ， 语 言 规范 中 是 用 * 符 写 表示 的 。 在 
语言 规范 并 没有 规定 为 得 询 构建 表达 式 树 时 ， 参 数 应 当 使 用 什么 名 称 。 
这 个 名 称 本 身 不 重要 ， 因 为 在 编写 碍 询 时 它 是 不 可 见 的 ， 因 此 把 它 称 为 
隐形 标识 符 。 


这 里 对 于 查询 表达 式 的 各 个 细节 不 做 更 多 介绍 ， 人 否则 至 少 需要 单独 一 章 
























































的 篇 幅 才能 讲 完 。 之 所 以 介绍 隐形 标识 符 ， 主 要 出 于 两 个 原因 : 首先 ， 
了 解 了 多 个 范围 变量 的 引入 规则 之 后 ， 便 于 读者 接受 和 学 习 碍 询 表达 式 
的 反 编译 结果 ; 其 次 ， 根 据 我 的 个 人 经 验 ， 隐 形 标识 符 是 使 用 查询 表达 
式 的 最 大 驱动 力 。 


3.7.3 ”选择 使 用 哪 种 LINQ 语 法 


查询 表达 式 表现 出 众 ， 但 是 它 并 不 总 是 表示 查询 的 最 简单 方式 。 查 询 表 
达 式 必须 以 from 子 句 开 始 ， 以 select 或 者 group by 子 句 结尾 。 虽 然 听 起 
来 尚 可 接受 ， 但 对 于 某 些 简单 过 滤 操 作 的 需求 ， 这 种 写法 就 显得 很 牺 拙 
了 ， 例 如 : 

from word in words 


where word.Length > 4 
select word 

















对 比 玉 用 扩展 方法 的 写法 : 
words.where(word => word.Length > 4) 
二 者 编译 后 的 结果 相同 5， 当 然 要 选 简 单 的 写法 。 


5 编译 器 在 处 理 select 子 句 时 提供 了 特殊 的 处 理 方法 ， 可 以 保证 只 选择 
当前 查询 元 素 。 


说 明 对 于 采用 非得 询 表 达 式 的 语法 ， 目 前 没有 统一 的 术语 ， 而 有 
方法 语法 、 点 式 语法 、 流 式 语 法 、lambda 语 法 等 名 称 ， 之 后 书 中 
会 统一 来 用 方法 语法 来 代称 。 对 于 这 儿 个 术语 之 间 的 细微 差别 ， 读 
者 无 须 费 心 分 辩 。 


当 查 询 变 得 更 复杂 时 ， 方 法 语法 依然 可 以 从 容 应 对 。LINQ 中 提供 的 很 
多 方法 ， 并 没有 与 之 对 应 的 查询 表达 式 语法 ， 包 括 select 和 where 的 某 
些 重 载 方法 。 这 些 重 载 方法 返回 的 是 元 素 以 及 元 素 对 应 的 索引 值 。 男 
外 ， 如 果 想 在 查询 的 结尾 执行 一 个 方法 调用 (例如 调用 ToList() 来 把 结 
果 转 换 成 List<T> 对 象 ) ， 束 要 把 整个 查询 表达 式 用 圆 括号 括 起 来 ;， 如 
果 使 用 方法 语法 ， 只 需 在 末尾 直接 添加 方法 调用 即 可 。 


我 并 不 是 不 推荐 使 用 查询 表达 式 。 在 很 多 情况 下 (包括 前 面 那 个 例子 在 
内 ) ， 两 种 方式 难 分 高 下 。 编 译 器 能 够 符 我 们 处 理 那些 隐形 标识 符 时 ， 
































也 是 查询 表达 式 绕 放 光芒 之 时 。 里 然 完 全 可 以 手动 实现 这 一 过 程 ， 但 根 
据 我 的 个 人 经 验 ， 如 果 自 行 构建 那些 匿名 类 型 ， 然 后 在 子 句 中 进行 拆 
解 ， 会 很 烦 开 ， 使 用 查询 表达 式 则 会 简单 许多 。 


最 后 ， 建 议 大 家 向 握 两 种 方式 。 不 窟 舍弃 哪 种 方式 ， 都 相当 于 放弃 增强 
代码 可 读 性 的 可 能 。 至 此 ，C# 3 的 所 有 特性 介绍 完毕 。 在 介绍 下 一 半 内 
容 之 前 ， 先 痰 谈 这 些 特性 是 如 何 构建 起 LINQ 世 界 的 。 





3.8 终极 形态 : LINQ 


这 部 分 不 会 介绍 当前 的 各 种 LINQ 提 供 器 。 我 目前 ) DO 
是 LINQ to Objects， 配 合 Enumerable 静 态 类 和 委托 使 用 。 下 面 介 绍 这 些 
特性 是 如 何 成 束 LINQ 的 。 假设 有 一 个 查询 从 Entity Framework 获 取 数 
据 ， 代 码 如 下 所 示 〔 假 设 已 存在 某 数 据 库 和 相应 的 表 结 构 〉: 


var products = from product in dbContext.Products 
where product.StockCount > 0 
orderby product.Price descending 
select new { product.Name, product.Price }; 


短 短 4 行 代码 ， 应 用 了 所 有 新 特性 。 
。 ， 包括 投射 初始 化 器 (只 选择 name 和 price 这 两 个 属 
ee 因为 无 法 声明 products 变 量 的 有 效 类 


本 当然 对 于 本 例 可 以 不 使 用 查询 表达 式 ， 但 对 于 更 复杂 
的 情况 ， 使 用 查询 表达 式 能 事半功倍 。 
。 lambda 表 达 式 。lambda 表 达 式 在 这 里 作为 查询 表达 式 转 译 之 后 的 结 


朱 。 
。 扩展 方法 。 它 使 得 转译 后 的 查询 可 以 通过 Queryable 类 实现 ， 因 
为 dbcontext. Products 实 现 了 IQueryable<Product> 接 口 。 
它 使 得 查询 逻辑 可 以 按照 数据 的 方式 传 给 LINQ 提 供 
， 然 后 转换 成 SQL 语 句 并 交 由 数据 库 执行 。 


不 管 缺少 上 述 哪个 特性 ，LINQ 的 实用 性 都 将 大 打折 扣 。 虽 然 我 们 可 以 
用 内 存 集合 来 取代 表达 式 树 ,虽然 不 用 查询 表达 式 也 能 写 出 可 读 性 比较 
强 的 简单 查询 ， 虽 然 不 用 扩展 方法 也 可 以 使 用 专用 的 类 配合 相关 方法 ， 














但 是 这 些 特性 加 在 一 起 将 别开生面 。 





3.9 ”小 结 
. 3 的 所 有 特性 都 和 数据 处 理 相 关 ， 大 部 分 属于 LINQ 的 核心 特 


4 二 

。 晶 动 属性 为 那些 不 需要 额外 行为 的 属性 提供 了 简洁 的 实现 方式 。 

。 使 用 var 关 键 字 声明 隐 式 类 型 ( 隐 式 类 型 数组 ) 对 于 匿名 类 型 的 处 
理 是 不 可 或 缺 的 ， 同 时 有 利于 减少 代码 元 余 。 

。 对 象 始 化 器 和 集合 初始 化 右 简 化 了 初始 化 过 程 ， 增 强 了 可 该 性 ， 同 
时 具备 了 在 单一 表达 式 内 完成 初始 化 的 能 力 ， 这 对 于 处 理 LINQ 的 
其 他 方面 至 关 重 要 。 

” 星 名 类 于 为 人 在 局 部 使 用 的 数据 类 恒 的 创建 提供 了 轻 量化 的 解决 万 

lambda 表 达 式 提供 了 比 匿 名 方法 更 简单 的 委托 创建 方式 。 同 时 可 以 

通过 表达 式 树 以 数据 的 方式 表示 代码 。LINQ 提 供 占 可 以 通过 该 功 

能 把 C# 的 查询 语句 转换 成 其 他 形式 (比如 SQL) 的 碍 询 语句 。 

扩展 方法 是 可 以 像 实例 方法 那样 调用 的 一 种 静态 方法 。 即 便 某 类 型 

最 初 没有 设计 成 流畅 接口 ， 也 可 以 之 后 通过 扩展 方法 来 实现 。 

查询 表达 式 会 被 转译 成 lambda 表 达 式 形式 的 C# 但 询 代 码 。 对 于 复杂 

人 

法 语法 。 











第 4 章 C#4: 互 操 作 性 提升 
本 章 内 容 概览 : 


。 使 用 动态 类 型 提升 互 操作 性 以 及 简化 反射 ; 

。 为 形 参 提供 默认 值 ， 调 用 方 不 必 指 定 对 应 实 参 ; 
。 为 方法 实 参 指定 名 称 使 其 表意 更 清晰 ; 

。 以 更 简洁 的 方式 使 用 COM 库 编码 ; 

。 通过 泛 型 型 变 实现 泛 型 类 型 转换 。 


C# 4 是 一 个 比较 有 意思 的 版 本 ， 最 重要 的 一 项 特性 是 引入 了 动态 类 型 。 
目 此 C#i 语 言 兼 备 静 态 类 型 (大 部 分 代码 ) 和 动态 类 型 (使 用 dynamic 关 
键 字 的 代码 ) ， 这 一 点 在 编程 语言 中 比较 少见 。 


动态 类 型 起 初 是 为 互 操 作 性 而 引入 的 ， 但 它 一 直 没 能 成 为 开发 人 员 的 日 
和 常 工 具 。 其 他 版 本 的 一 些 主 要 特性 (比如 泛 型 、LINQ、async/await) 
早已 成 为 大 部 分 C# 程 序 员 的 手头 工具 ， 但 动态 类 型 的 使 用 频 度 依然 相对 
较 低 。 可 以 肯定 的 是 ， 在 真正 需要 动态 类 型 的 场景 ， 定 有 其 用 武之 地 。 
退 一 万 步 讲 ， 这 个 特性 至 少 很 有 趣 。 


C# 4 中 的 其 他 特性 也 对 互 操作 性 有 所 提升 ， 尤 其 是 在 使 用 COM 组 件 时 。 
有 些 改 进 是 针对 COM 设 计 的 ， 比 如 命名 索引 器 、 隐 式 ref 实 参 以 及 磐 入 
式 互 操作 类 型 。 可 选 形 参 和 命名 实 参 在 处 理 COM 组 件 时 大 有 作为 ， 还 
可 以 用 于 纯 托 管 代 码 。 这 是 我 日 常用 到 的 C# 4 中 的 两 个 特性 。 


最 后 ，C# 4 还 提供 了 一 个 关于 泛 型 的 特性 ， 该 特性 从 CLR 的 v2 版 本 
CCLR 包 售 泛 型 的 第 一 个 运行 版 本 ) 开始 启用 。 泛 型 型 变 (generic 
variance) 既 简 单 又 复杂 。 刚 接触 时 ， 一 般 会 觉得 这 个 特性 非常 直观 : 
比如 string 类 型 的 序列 显然 是 object 类 型 的 序列 ， 但 是 有 些 程序 员 很 难 
理解 为 什么 string 类 型 的 list 不 是 object 类 型 的 list。 这 个 特性 虽然 用 途 广 
泛 ， 但 深 守 起 来 师 为 复杂 。 大 部 分 情况 下 ， 我 们 浑然 不 党 地 应 用 了 该 特 
性 。 和 希望 通 过 本 章 的 讲解 ， 当 读者 因 代 码 运行 不 畅 需 要 探查 原因 时 ， 会 
有 一 个 更 清晰 的 脉络 ， 从 而 轻松 解决 问题 。 首 先 介绍 动态 类 型 。 


4.1 动态 类 型 


IN 大- 























有 些 特性 的 难点 主要 集中 在 引入 的 新 语法 ， 掌 握 语法 后 基本 上 就 理解 特 
性 了 。 然 而 动态 类 型 刚好 相反 : 语法 极其 简单 ， 但 就 其 影响 和 实现 层面 
而 言 ， 会 引出 近乎 无 穷 的 细节 。 本 章 会 介绍 动态 类 型 的 基础 知识 ， 并 深 
es 节 ， 最 后 对 于 动态 类 型 的 使 用 场景 和 使 用 方式 给 出 一 些 相 
大 建议 。 














4.1.1 动态 类 型 介绍 





首先 看 一 个 示例 。 代 码 清单 4-1 展 示 了 从 文本 中 获取 子 串 的 两 种 方式 。 
这 里 暂 不 解释 为 什么 使 用 动态 类 型 ， 只 是 展示 其 用 法 。 
代码 清单 4-1 使 用 动态 类 型 获取 子 串 


dynamic text = "hello world"; <------ 使 用 动态 类 型 声明 变量 
string world = text.Substring(6); <------ 调用 Substring 方 法 。 没 有 问 是 
Console.writeLine(world); 














string broken = text.SUBSTR(6); <------ 调用 SUBSTR。 抛 出 异常 
Console.writeLine(broken); 


这 一 小 段 代 码 缘 后 涉及 很 多 内 容 ， 其 中 最 重要 的 一 点 是 ， 它 完全 可 以 通 
过 编译 。 如 果 把 第 一 行 text 的 类 型 改 成 string， 那 么 后 面 调用 suBSTR 的 
位 置 会 编译 报错 。 实 际 上 ， 编 译 器 在 编译 这 段 代 人 码 时 ， 不 会 查找 名 

为 SuBSTR 的 方法 是 否 存在 ， 也 不 会 查找 substring 方 法 。 查 找 这 两 个 方法 
发 生 在 执行 期 。 


第 2 行 代码 在 执行 期 会 查找 一 个 名 为 substring 且 能 够 匹配 6 这 个 实 参 的 
方法 ， 找 到 该 方法 并 且 执 行 之 后 会 返回 一 个 字符 串 ， 将 字符 串 赋值 给 
world 变 量 ， 之 后 wor1ld 变 量 束 可 以 正常 打印 了 。 等 到 代码 尝试 查找 名 
为 suBsTR 且 [匹配 实 参 6 的 方法 时 ， 发 现 无 法 找到 ， 之 后 代码 执行 失败 并 


且 抛 出 RuntimeBinderException。 


第 3 和 章 讲 过 ， 在 特定 上 下 文中 碍 找 符号 含义 的 过 程 称 为 绑 定 。 动 态 类 型 
是 把 绑 定 过 程 从 编译 时 转移 到 了 执行 期 。 使 用 静态 类 型 ， 编 译 器 生成 的 
开 代 码 中 包含 的 是 精准 的 方法 签名 的 调用 ;而 使 用 动态 类 型 ， 编 译 器 生 
成 的 于 代 码 的 功能 是 执行 绑 定 并 执行 绑 定 的 结 末 。 这 一 切 都 是 

由 dynamic 关 键 字 触发 的 。 


1. 什么 是 动态 类 型 

















代码 清单 4-1 使 用 dynamic 类 型 声明 了 text 变 量 : 
dynamic text = "hello world"; 


dynamic 是 什么 类 型 呢 ?dynamic 类 型 不 同 于 前 面 讲 过 的 C# 中 的 其 他 
类 型 ， 它 只 存在 于 C# 中 : system.Type 中 没有 dynamic 的 定义 ，CLR 
也 对 该 类 型 一 无 所 知 。 在 C# 中 使 用 dynamic， 并 都 会 转换 成 带 
有 [Dynamic] 属 性 的 obpject 来 声明 。 
说 明 ” 当 dynamic 用 于 方法 签名 时 ， 编 译 器 需要 为 相关 代码 提 
| 0 如 果 用 于 局 部 变量 ， 则 不 会 采用 此 策 
使 用 dynamic 有 以 下 基本 规则 。 
(1) 非 指 针 类 型 到 dynamic 类 型 存在 隐 式 类 型 转换 。 
(2) dynamic 类 型 的 表达 式 到 任意 非 指 针 类 型 存在 隐 式 类 型 转换 。 


人 通常 都 是 在 执行 期 才 完成 绑 














(4) 大 部 分 含有 dynamic 类 型 值 的 表达 式 ， 表 达 式 编译 时 的 类 型 也 


是 dynamic。 


稍 后 会 给 出 最 后 两 条 的 反例 。 有 了 上 述 规则 ， 重 新 审视 代码 清单 4- 
1， 首 先 看 前 两 行 : 


"hello wor]d"， 
text.Substring(6); 


dynamic text 
string world 


第 1 行 代码 中 ，string 类 型 转换 成 了 dynamic 类 型 ， 这 是 可 行 的 〈 参 
考 第 1 条 规则 ) 。 第 2 行 代码 则 展示 了 另外 3 条 规则 : 


o text.Substring(6) 在 执行 期 完成 绑 定 (第 3 条 规则 )，; 

o text.Substring(6) 在 编译 时 的 类 型 是 dynamic (第 4 条 规则 ) ，; 

O text.Substring(6) 到 string 有 一 个 隐 式 类 型 转换 (第 2 条 规 
则 ) 。 








把 dynamic 类 型 的 表达 式 转换 成 非 dynamic 类 型 ， 这 个 过 程 也 是 动态 
绑 定 的 。 如 果 将 wor1d 变 量 声明 为 int 类 型 ， 编 译 会 通过 ， 但 是 在 执 
行 期 会 殷 出 RuntimeBinderException。 如 果 将 world 声 明 

为 XNamespace 类 型 ， 编 译 会 通过 ， 在 执行 期 绑 定 器 会 根据 用 户 自 定 
义 的 隐 式 类 型 转换 ， 将 string 转 换 为 XNamespace。 记 住 这 点 之 后 ， 
再 看 几 个 动态 绑 定 的 例子 。 








. 在 多 个 上 下 文中 应 用 动态 绑 定 

前 面 介 绍 了 方法 调用 动态 结果 的 动态 绑 定 以 及 之 后 的 类 型 转换 ， 不 
过 几乎 所 有 行为 在 执行 时 都 可 以 是 动态 的 。 代 码 清单 4-2 展 示 了 在 
人 根据 执行 期 动态 值 的 类 型 执行 3 种 加 法 操 


代码 清单 4-2 动态 类 型 的 加 法 操作 


static void Add(dynamic d) 








Console.writeLine(d + d); <------ 在 执行 期 根据 类 型 执行 加 法 操作 
} 
Add("text" ); (本 行 及 以 下 2 行 ) 使 用 不 同 的 值 调用 方法 


Add(10); 
Add(TimeSpan.FromMinutes(45)); 


执行 结果 如 下 : 
texttext 


20 
01:30:00 


上 面 例子 中 加 法 操作 的 每 个 类 型 都 是 合理 的 ， 但 如 条 换 成 静态 类 型 
的 上 下 文 ， 写 法 就 会 大 不 相同 。 最 后 看 看 涉及 动态 参数 的 方法 重 载 
代码 清单 4-3 动态 方法 重 载 决 议 


static void SampleMethod(int value) 








Console.WwriteLine("Method with int parameter"); 


static void SampleMethod(decimal value) 


Console.writeLine("Method with decimal parameter"); 
} 
static void SampleMethod(object value) 
{ 

Console.writeLine("Method with object parameter"); 
} 


static void CallMethod(dynamic d) 





SampleMethod(d); <------ 动态 调用 方法 
} 
CallMethod(10); (本 行 及 以 下 3 行 ) 使 用 不 同类 型 间接 调用 SampleMethod 方 >》 
CallMethod(10.5m); 


CallMethod(10L); 
CallMethod("text"); 


执行 结果 如 下 : 


Method with int parameter 

Method with decimal parameter 
Method with decimal parameter 
Method with object parameter 


需要 重点 关注 执行 结果 的 最 后 两 行 :执行 期 的 重 载 决议 也 会 顾及 类 
型 转换 。 第 3 行 结果 ，1long 类 型 的 值 转换 成 了 decimal 而 不 是 int， 
虽然 该 值 也 在 int 类 型 的 范围 内 。 第 4 行 结果 ，string 类 型 的 值 转换 
成 了 object 类 型 。 执 行 期 的 绑 定 行为 会 尽 可 能 与 编译 时 的 绑 定 行为 
一 致 ， 其 绑 定 依据 是 动态 值 在 执行 期 的 类 型 。 


只 有 动态 值 才 会 被动 态 处 理 


编译 占 会 保证 执行 期 能 够 获得 尽 可 能 准确 的 信息 。 当 绑 定 过 程 
涉及 多 个 值 ， 静 态 类 型 值 使 用 的 是 编译 时 类 型 ， 而 动态 类 型 值 
使 用 的 是 执行 期 类 型 。 这 点 细微 差别 在 大 部 分 情况 下 可 以 忽略 
人 
参阅 。 


经 动态 绑 定 的 方法 调用 ， 其 结果 的 类 型 都 是 编译 时 类 型 dynamic。 











当 绑 定 发 生 时 ， 如 果 被 选中 的 方法 的 返回 类 型 是 void， 并 且 方 法 的 
结果 被 使 用 《〈 例 如 给 茶 个 变量 赋值 ) ， 绑 定 就 会 失败 。 大 部 分 动态 
绑 定 操作 与 之 机 制 相同 : 编译 占 对 于 动态 操作 会 罕 涉 哪些 信息 知之 
甚 少 ， 不 过 依然 存在 几 种 例外 情况 。 


. 在 动态 绑 定 的 上 下 文中 ， 编 译 器 做 哪些 检查 
如 果 在 编译 时 就 能 获得 一 个 方法 调用 的 上 下 文 ， 那 么 编译 占 可 以 检 
得 能 个 找到 该 特定 名 称 的 方法 。 如 果 找 不 到 能 够 在 执行 期 调用 的 方 
法 ， 依 然 会 引发 编译 错误 。 该 规则 适用 于 以 下 场景 : 

o 目标 不 是 动态 值 的 实例 方法 和 索引 器 ; 

© 静态 方法 ; 

o 构造 器 。 


代码 清单 4-4 展 示 了 几 个 使 用 动态 值 的 方法 调用 ， 这 些 调用 在 编译 
时 均 会 报错 。 


代码 清单 4-4 涉及 动态 值 的 编译 错误 示例 


dynamic d = new object(); 


int invalid1 = "text" ,Substring(9，1，2，d);， <------ 不 存在 接收 
bool invalid2 = string,Equals<int>("foo"，d)，<------ 不 存在 泛 : 
string invalid3 = new string(d, "broken"); <------ 不 存在 接收 两 
char invalid4 = "text"[d, d]; <------ 不 存在 接收 两 个 参数 的 String: 








编译 器 能 够 《但 并 不 总 是 ) 得 知 上 述 特定 例子 会 在 运行 时 会 出 错 。 
使 用 动态 绑 定 容易 陷入 茶 些 不 确定 的 状态 中 ， 因 此 在 处 理 动态 值 时 
需要 格外 诺 惯 。 


前 面 这 些 例子 假设 能 够 通过 编 详 ， 依 然 会 使 用 动态 绑 定 ， 但 也 有 例 
外 。 











. 有 哪些 有 动态 值 参 与 的 操作 ， 但 并 非 动 态 绑 定 


绝 大 部 分 处 理 动态 值 的 操作 会 涉及 : 类 型 绑 定 、 碍 找 合适 方法 、 属 
性 、 转 换 或 者 运算 符 等 ， 但 还 有 一 些 情况 ， 编 译 占 不 需要 为 其 生成 








绑 定 代码 。 


o 给 一 个 类 型 是 object 或 者 dynamic 的 变量 赋值 。 因 为 不 需要 类 
型 转换 ， 所 以 编译 器 只 需 复制 现 有 的 引用 。 

o 传 入 方法 的 参数 类 型 是 object 或 者 dynamic。 和 上 一 条 类 似 ， 
只 不 过 是 把 变量 换 成 参数 。 

o 使 用 is 运算 符 判 断 某 个 值 的 类 型 。 

o 使 用 as 运算 符 转 换 某 个 值 的 类 型 。 


如 果 要 把 茶 个 动态 值 通过 显 式 或 隐 式 方式 转换 成 用 户 目 定义 的 类 
型 ， 尽 管 执 行 期 绑 定 系统 可 以 执行 这 样 的 转换 ， 但 is 运算 符 和 as 运 
算 符 并 不 能 使 用 定义 转换 ， 因 此 也 不 需要 绑 定 操作 。 同 样 ， 几 乎 所 
有 带动 态 值 的 操作 ， 结 果 也 都 是 动态 的 。 








5. 哪些 操作 有 动态 值 参与 但 是 依然 是 静态 类 型 


编译 器 会 尽力 帮忙 执行 类 型 检查 。 如 果菜 个 表达 式 的 类 型 只 能 是 某 
个 唯一 类 型 ， 那 么 编译 器 会 为 其 赋予 编译 时 类 型 。 假 设 有 变量 d， 
其 类 型 是 dynamic， 那 么 下 和 面 3 种 情况 都 是 正确 的 。 


o new SomeType(d) 表 达 式 具备 编译 时 类 型 someType， 尺 管 该 构造 
器 在 执行 期 才 会 被 动态 绑 定 。 

o d is SomeType 表 达 式 具备 编译 时 类 型 boo1。 

o d as SomeType 表 达 式 具备 编译 时 类 型 someType。 


关于 动态 类 型 就 介绍 到 这 里 。4.1.4 节 将 讨论 在 编译 时 和 执行 期 都 存 
在 的 意外 扭曲 现象 。 了 解 了 动态 类 型 的 一 些 基础 知识 ， 下 面 介 绍 动 
态 类 型 除 执行 期 绑 定 外 的 其 他 功能 。 


4.1.2 ”超越 反射 的 动态 行为 


动态 类 型 的 一 个 作用 是 ， 可 以 要 求 编译 费 和 framework 根 据 类 型 的 成 员 
执行 利 规 的 反射 操作 。 不 过 动态 类 型 的 灵活 作用 远 不 止 于 此 。 引 入 动态 
类 型 的 一 个 原因 是 提升 和 动态 语言 的 互 操作 性 ， 这 样 可 以 允许 动态 语言 
在 绑 定 时 动态 变化 。 很 多 动态 语言 多 许 在 执行 期 拦截 方法 。 这 一 点 很 有 
用 ， 比 如 用 于 透明 缓存 或 者 日 志 ， 也 可 以 为 方法 添加 没有 预先 定义 的 功 
能 或 者 字段 。 


























1. 一 个 假想 的 数据 库 访问 的 例子 


假定 有 一 个 需求 : 茶 个 数据 库 包含 一 个 名 为 book 的 表 ， 表 中 包 
售 author 字 段 。 动 态 类 型 允许 以 如 下 方式 编码 : 
dynamic database = new Database(connectionSstring); 


var books = database.Books.SearchByAuthor("Holly Webb"); 
foreach (var book in books) 





Console.writeLine(book.Title); 


这 段 代 码 涉及 以 下 几 个 动态 操作 。 


o Database 类 会 对 Books 属 性 请 求 做 出 啊 应 ， 它 会 回 数 据 库 
schema 发 起 对 Books 表 的 请 求 ， 并 且 返 回 某 个 table 对 象 。 

O 该 table 对 象 可 以 啊 应 searchByAuthor 方 法 调用 : 它 识 别 出 该 方 
法 以 searchBy 开 头 ， 然 后 在 schema 中 查找 一 个 名 为 Author 的 
列 ， 接 着 生成 SQL 语句 ， 通 过 提供 的 参数 得 询 该 列 ， 并 且 返 回 
一 个 行 对 象 的 列表 。 

o 每 个 行 对 象 都 可 以 啊 应 Title 属 性 并 且 返 回 Title 列 的 值 。 


以 上 代码 对 熟悉 Entity Framework 或 者 其 他 ORM (object-relational 
mapping) 的 读者 来 说 应 该 不 陌生 。 通 过 手动 创建 《〈 或 者 schema 生 
成 ) 某 些 类 来 实现 上 述 碍 询 功能 也 不 难 ， 但 两 种 方式 的 区 别 是 ， 前 
者 是 动态 的 : 并 不 存在 Book 或 者 BooksTable 类 ， 这 些 调用 啊 应 都 发 
生 在 执行 期 。4.1.5 节 还 会 从 宏观 上 继续 探讨 该 特性 的 优 缺 点 ， 现 在 
读者 只 需要 知道 动态 类 型 在 某 些 场景 中 频 为 实用 即 可 。 


在 介绍 文 撑 动 态 类 型 背后 的 类 型 基础 之 前 ， 先 看 几 个 应 用 动态 类 型 
的 例子 。 首 先 介 绍 framework 中 的 一 个 类 型 ， 然 后 介绍 Json.NET。 




















2. Expandoobject: 一 个 装 有 数据 和 方法 的 动态 袋子 


.NET Framework 提 供 了 一 个 名 为 Expandoobject 的 类 型 ， 位 于 
System.Dynamic 命 名 空间 下 。 该 类 型 有 两 种 工作 模式 ， 视 是 人 否 将 议 
类 型 当 作 动态 值 而 定 。 人 代码 清单 4-5 有 助 于 读者 对 后 续 内 容 有 一 个 
大 致 的 概念 。 








代码 清单 4-5” 在 Expando0bject 中 存 取 items 


dynamic expando = new ExpandoObject(); 

expando ,SomeData = "Some data"; <------ 将 数据 赋值 给 属性 

Action<string> action = (本 行 及 以 下 2 行 ) 将 委托 赋值 给 属性 
input => Console.WriteLine("The input was '{0}'", input); 

expando.FakeMethod = action,; 





i 








Console .writeLine(expando.SomeData); (本 行 及 以 下 1 行 ) 动态 访问 数据 
expando.FakeMethod("hello"); 


IDictionary<string, object> dictionary = expando; (本 行 及 以 下 2 
Console.writeLine("Keys: {0}", 
string.Join(", ", dictionary.Keys)); 

















dictionary["0OtherData"] = "other"; (本 行 及 以 下 1 行 ) 使 用 静态 上 下 文 : 
Console.WriteLine(expando.OotherData) ; 


当 Expandoobject 用 于 一 个 静态 类 型 的 上 下 文中 ， 人 

由 name/value 对 组 成 的 字典 ， 与 普通 的 字典 一 样 实 现 了 
IDictionary<string，object>， 也 可 以 用 作 普 通 字 典 ， 例 如 在 执行 
期 进行 键 的 查找 等 。 


此 外 ， 它 还 实现 了 IDpynamicMetaobjectProvider 接 口 ， 访 接口 是 动 
态 行为 的 入 口 ， 后 面 会 探讨 该 接口 。Expandoobject 实 现 该 接口 

后 ， 我 们 就 可 以 在 代码 中 通过 名 字 来 访问 字典 的 键 了 。 当 在 动态 上 
下 文中 调用 Expandoobject 的 方法 时 ， 它 会 像 字 典 中 的 键 一 样 查 找 
方法 名 。 如 果 这 个 键 对 应 的 值 是 一 个 委托 并 为 其 提供 了 合适 的 参 
数 ， 委 托 会 被 执行 ， 委 托 返 回 的 结果 就 会 成 为 该 方法 调用 的 结果 。 


里 然 代码 清单 4-5 只 存储 了 一 个 数值 和 一 个 委托 ， 但 理论 上 可 以 存 
储 任意 多 个 对 象 。 它 相当 于 一 个 可 以 动态 访问 的 字典 。 


也 可 以 使 用 Expandoobject 来 实现 之 前 那个 数据 库 的 例子 。 我 们 可 
以 创建 一 个 Expandoobject 来 表示 Books 表 ， 然 后 使 用 单独 的 
Expando0bject 表 示 每 本 书 。 该 表 将 有 一 个 SearchByAuthor 的 键 ， 该 
键 对 应 一 个 委托 来 负责 执行 查询 。 每 本 书 还 有 一 个 Title 的 键 用 于 
保存 书 名 信息 ， 等 等 。 不 过 在 实际 工作 中 ， 一 般 会 选择 直接 实现 
IDynamicMetaobjectProvider 接 口 ， 或 是 使 用 Dynamicobject。 稍 后 
会 继续 讨论 这 两 个 类 型 ， 首 先 看 一 下 动态 类 型 的 男 一 个 应 用 : 动态 
访问 JSON 数 据 。 














3，Json.NET 的 动态 视图 


如 今 JSON 应 用 广泛 。 用 于 创建 和 消费 JSON 数 据 的 一 个 流行 的 库 是 
Json.NET1。 它 提供 了 多 种 处 理 JSON 数 据 的 方式 ， 可 以 直接 解析 成 
自 定 义 类 ， 也 可 以 解析 成 类 似 于 LINQ to XML 这 样 的 对 象 模型 ， 后 
者 被 称 为 LINQ to JSON， 它 操作 的 类 型 通常 是 Jobject、JArray 和 
JProperty。 它 的 使 用 方式 类 似 于 LINQ to XML， 通 过 字符 串 进 行 
访问 ， 也 可 以 执行 动态 操作 。 代 码 清单 4-6 使 用 了 两 种 方式 来 处 理 
同一 个 JSON 数 据 。 


代码 清单 4-6 动态 地 使 用 JSON 数 据 
string json = @'" (本 行 及 以 下 7 行 ) 硬 编码 的 JSON 数 据 
{ 


'name': 'Jon Skeet '， 
'address': { 
'town': 'Reading', 


'country': UK: 
} 
}".Replace('\'', J 


Jobject obj1 = JObject.Parse(json); <------ 将 JSON 解 析 成 JObjec 











Console.WwriteLine(obji["address"]["town"]); <------ 使 用 静态 类 和 











dynamic obj2 = obj1; (本 行 及 以 下 1 行 ) 使 用 动态 类 型 视图 
Console.WriteLine(obj2.address.town) ; 


虽然 只 是 一 个 简单 的 JSON， 但 其 中 包含 了 一 个 骨 套 的 对 象 。 人 代码 
的 后 半 部 分 展示 了 : 访问 JSON 数 据 ， 既 可 以 使 用 LINQ to JSON 提 
供 的 索引 器 ， 也 可 以 使 用 它 提 供 的 动态 视图 。 


读者 倾 问 于 哪 种 方式 呢 ? 关于 两 种 方式 一 直 存 在 各 种 争议 。 不 管 是 
采用 字符 串 字 面 量 还 是 采用 动态 属性 访问 ， 两 种 方式 都 容易 让 人 犯 
拼写 错误 。 采 用 静态 类 型 方式 ， 因 为 床 用 字符 串 作 为 属性 名 称 ， 所 
以 可 复 用 度 高 ， 采 用 动态 类 型 方式 ， 在 原型 设计 时 更 便于 阅读 。 
4.1.5 节 会 探讨 动态 类 型 的 适用 场景 ， 不 过 在 此 之 前 ， 建 议 读者 先 建 
立 初 步 的 想法 。 下 面 介 绍 如 何 全 手动 实现 动态 行为 。 




















4. 用 代码 实现 动态 行为 


动态 行为 的 内 容 比 较 复 杂 ， 不 过 这 里 暂 不 考虑 这 些 复杂 的 部 分 。 本 
章 内 容 不 足以 文 撑 顺 畅 目 如 地 编写 产品 级 优化 的 实现 方案 ， 对 于 动 
态 类 型 来 说 只 是 一 个 开始 ， 还 远 不 是 终点 。 本 章 仅 提供 足够 的 知识 
供 读者 就 该 特性 开展 探索 和 实践 ， 以 便 决 定 还 要 付出 多 少 努 力 来 继 
续 深 入 探 宛 动态 类 型 。 





前 面 提 到 Expandoobject 类 型 实现 了 IDynamicMetaobjectProvider 接 
口 。 该 接口 指明 : 对 象 应 当 实 现 上 自身 的 动态 行为 ， 而 不 是 通过 反射 
框架 那 种 普通 的 方式 实现 。 作 为 一 个 接口 ， 它 看 起 来 很 简单 ， 但 请 
不 要 被 这 个 假象 所 欺骗 : 


public interface IDynamicMetaObjectProvider 


{ 








DynamicMetaobject GetMetaObject(Expression parameter); 


因为 真正 复杂 的 部 分 都 位 于 DynamicMetaobj ect 之 中 ) 它 是 其 他 所 有 
行为 的 驱动 力 。 在 考虑 该 类 型 时 ， 可 以 参考 官方 文档 给 出 的 定义 : 


代表 了 动态 绑 定 和 参与 到 动态 绑 定 过 程 中 对 象 的 绑 定 逻辑 。 


尽管 我 使 用 过 这 个 类 ， 但 依然 不 敢 保 证 完全 理解 上 面 这 名 话 ， 也 无 
法 给 出 更 好 的 定义 。 通常 需要 创建 一 个 继承 自 DynamicMetaobject 的 
类 ， 并 且 完 成 一 些 虚 方法 的 覆盖 。 如 果 要 动态 地 处 理 方法 调用 ， 可 
以 像 下 面 这 样 禾 盖 这 个 方法 : 


public virtual DynamicMetao0bject BindInvokeMember 
(InvokeMemberBinder binder, DynamicMetaObject[] args ) ， 


binder 参 数 负 责 给 出 被 调用 方法 的 名 称 、 调 用 方 是 否 需要 区 分 大 小 
写 的 绑 定 方 式 等 信息 ; 而 args 参 数 则 是 调用 方 提供 的 实 参 列表 ， 实 
参 列表 中 是 一 些 DynamicMetaobject。 返 回 值 也 是 一 

个 DynamicMetaobject， 用 于 表示 应 当 如 何人 处 理 方法 调用 。 它 不 会 六 
刻 执行 方法 调用 ， 而 会 创建 一 棵 表达 式 树 来 表示 调用 的 行为 。 


上 述 过 程 涉及 的 内 容 都 极其 复杂 ， 但 可 以 有 效 处 理 各 种 复杂 情况 。 
还 好 我 们 不 需要 亲自 动手 实现 IDynamicMetaobjectProvider， 本 书 
也 不 会 做 类 似 的 和 尝试。 下面 介 绍 一 个 比较 友好 的 类 














型 : Dynamicobject。 


Dynamicobject 作 为 实现 动态 行为 类 的 基 类 ， 可 以 将 实现 动态 行为 
的 过 程 尽 可 能 地 简化 。 虽 然 其 结 末 可 能 个 如 实现 
IDynamicMetaobjectProvider 效 率 高 ， 但 更 容易 理解 。 


接 下 来 创建 一 个 名 为 SimpleDynamicExample 的 类 ， 该 类 型 具备 以 下 
动态 行为 。 
o。 调用 该 类 型 的 任何 方法 ， 都 会 在 终端 打印 一 行 信息 ， 打 印 内 容 
包含 方法 名 和 参数 。 
o 获取 一 个 属性 时 ， 返 回 该 属性 的 名 称 。 名 称 中 会 包含 一 个 前 
级 ， 该 前 级 用 于 指示 当前 调用 为 动态 调用 。 
代码 清单 4-7 展 示 了 SimpleDynamicExample 类 的 使 用 方式 。 
代码 清单 4-7 动态 行为 的 针对 性 使 用 


dynamic example = new SimpleDynamicExample( ); 
example.CallSomeMethod("x", 10); 
Console.writeLine(example.SomeProperty); 


输出 结果 如 下 : 


Invoked: CallSomeMethod(x, 10) 
Fetched: SomeProperty 

















callSomeMethod 和 SomeProperty 的 名 字 本 和 号 没 有 任何 特殊 性 ， 但 可 

以 根据 需要 以 不 同方 式 指定 特定 名 称 。 截 至 目前 ， 即 便 是 讲 过 的 简 
也 很 难 正确 应 用 底层 接口 ， 但 使 用 Dynamicobject 的 话 就 

很 简单 。 


代码 清单 4-8 ”simpleDynamicExample 的 实现 











class SimpleDynamicExample : Dynamicobject 














public override bool TryInvokeMember( (本 行 及 以 下 9 行 ) 处 理 方 
InvokeMemberBinder binder, 
object[] args, 
out object result) 








Console.writeLine("Invoked: {0}({1})", 
binder.Name, string.Join(", ", args)); 

result = null; 

return true; 


} 


public override bool TryGetMember( (本 行 及 以 下 6 行 ) 处 理 属 性 访 
GetMemberBinder binder, 
out object result) 


























result = "Fetched: " + binder.Name; 
return true; 


} 


与 DynamicMetaobject 中 的 方法 一 样 ， 当 对 Dynamicobject 的 方法 进 
行 覆 盖 之 后 ， 可 以 正常 接收 binder 了 ， 但 无 须 再 关心 表达 式 树 或 其 
他 DynamicMetaobject 值 。 方法 的 返回 值 用 于 指示 动态 对 象 是 否 成 功 
处 理 相 关 操 作 。 若 返回 false， 则 会 掀 出 RuntimeBinderException。 


关于 实现 动态 行为 ， 就 介绍 到 这 里 。 和 希望 代码 清单 4-8 能 够 激励 读 
者 继续 实践 Dynamicobject。 即 便 将 来 没有 机 会 用 于 产品 级 代码 ， 

当 作 练 习 也 可 自得 其 乐 。 如 果 读 者 苦于 没有 具体 的 练习 素材 ， 那 么 
可 以 试 试 实现 本 章 开 始 Database 的 例子 ， 即 实现 下 面 这 段 代码 : 
dynamic database = new Database(connectionSstring); 


var books = database.Books.SearchByAuthor("Holly Webb"); 
foreach (var book in books) 














Console.writeLine(book.Title); 


下 面 看 看 在 处 理 动态 值 时 ，C# 编 译 器 会 生成 怎样 的 代码 。 


1 当然 ， 还 有 其 他 JSON 库 ， 只 不 过 我 个 人 对 Json.NET 最 熟悉 。 
4.1.3 ”动态 行为 机 制 速 览 


读者 应 该 已 经 发 现 ， 我 很 喜欢 探究 C# 编 译 器 如 何 通过 堪 来 实现 各 种 新 特 
性 。 前 面 讲 过 lambda 表 达 式 中 捕获 变量 如 何 引 发 额外 的 类 创建 ，lambda 
表达 式 转 换 成 表达 式 树 引 发 Expression 类 方法 调用 。 动 态 类 型 的 实现 机 
制 有 些 类 似 于 表达 式 树 ， 它 们 都 是 将 代码 转换 成 数据 的 表达 模式 ， 不 过 





动态 类 型 的 规模 更 为 庞大 。 
这 部 分 所 涉 细 布 比 前 文 少 。 尽 管 细节 本 身 很 有 意思 ， 但 是 并 不 需要 深入 
丁 解 2。 好 在 这 部 分 内 容 是 完全 开源 的 。 如 果 读 者 感觉 意犹未尽 ， 可 以 
阅读 源码 并 深入 探究 。 下 面 先 从 各 子 系统 与 其 负 员 的 动态 类 型 方面 说 
起 。 
2 实话 说 ， 我 目 己 也 没有 掌握 全 部 细节 。 

1. 职责 划分 


考量 一 个 C# 特 性 的 时 候 ， 通 常会 自然 地 将 职责 划分 为 3 部 分 : 





























o 人 amework 库 


有 些 特 性 基本 属于 C# 编 译 器 范畴 ， 比 如 隐 式 类 型 。framework 不 需 
要 提供 任何 类 型 来 支持 var， 运 行 时 对 于 某 个 类 型 是 显 式 还 是 隐 式 
也 是 一 无 所 知 。 


与 之 相对 的 另 一 个 极端 是 泛 型 : 泛 型 需要 编译 器 、 运 行 时 和 
framework 的 全 方位 文 持 “〈 通 过 反射 API) 。 而 LINQ 处 于 中 间 位 
置 : 第 3 章 讲 到 编译 器 有 很 多 特性 ，framework 则 提供 了 LINQ to 
Objects 以 及 表达 式 树 的 API， 但 运行 时 没有 提供 相关 支持 。 对 于 动 
态 类 型 ， 情 况 还 要 更 复杂 一 些 。 图 4-1 用 图 形 化 的 方式 展示 了 动态 
类 型 所 获得 的 文 持 。 














图 4-1 动态 类 型 所 涉 组 件 图 示 


CLR 没 有 变动 之 处 ， 不 过 我 认为 从 v2 到 v4 版 本 的 优化 也 部 分 地 受到 
了 动态 类 型 的 驱动 。 首 先 编译 器 肯定 参与 其 中 ， 它 负 贡 生成 各 种 
IL， 稍 后 给 出 相关 例子 。 人 至 于 framework 或 者 库 的 支持 ， 主 要 有 两 
个 方面 。 第 一 是 动态 语言 运行 时 (dynamic language runtime， 

DLR) ， 它 提供 了 与 语言 无 关 的 基础 架构 ， 例 如 
DynamicMeta0bject。 访 架构 负责 执行 万 有 动态 行为 。 第 二 个 是 
Microsoft.CSharp.dll， 但 该 库 并 不 属于 核心 framework。 














说 明 ”Microsoft.CSharp.dll 库 虽然 是 随 framework 一 同 发 布 的 ， 
但 是 并 不 属于 系统 framework 库 的 一 部 分 ， 而 应 该 算 作 一 个 第 
三 方 库 依赖 ， 只 不 过 此 第 三 方刚 好 是 微软 而 已 。 从 另 一 个 角度 
做 钦 CH 网 详 器 和 该 库 有 者 强 耦 合 的 关系， 因此 很 难 将 其 恰 
~ 归 类 。 


Microsoft.CSharp.dll 库 主要 人 负责 与 C# 语 言 相关 的 所 有 特定 部 分 。 假 





设 东 个 方法 调用 的 共 个 参数 是 动态 值 ， 那 么 由 该 库 负责 在 运行 时 进 
行 重 载 决议 。 该 库 是 C# 编 译 占 绑 定 部 分 的 一 个 副本 ,但 区 别 是 它 要 
在 全 动态 的 API 上 下 文中 实施 绑 定 。 


如 果 读 者 注意 过 项 目 中 的 Microsoft.CSharp.dl1 引 用 ， 并 对 该 库 的 作 
用 感到 疑惑 ， 那 现在 应 该 都 清楚 了 。 如 果 项 目 中 没有 使 用 任何 动态 
类 型 ， 那 么 完全 可 以 移 除 该 库 的 引用 ， 如 果 代 码 中 使 用 了 动态 类 

型 ， 而 又 没有 添加 对 该 库 的 引用 ， 编 译 时 就 会 报错 ， 因 为 C# 编 译 器 
会 生成 对 该 程序 集 的 调用 代码 。 既 然 谈 到 编译 器 生成 代码 的 问题 ， 

下 面 趁 热 打铁 介绍 一 些 相 关内 容 。 








. 动态 类 型 生成 的 和 代码 
回 到 本 半 开 始 的 例子 ， 对 其 稍 作 简 化 ， 得 到 下 面 两 行 代码 : 


dynamic text 
string world 





"hello world"; 
text.Substring(6); 


很 简单 吧 ? 其 中 包含 了 两 个 动态 操作 : 


o Substring 方 法 的 调用 ; 
o Substring 方 法 执行 结果 转换 为 string 类 型 。 


代码 清单 4-9 是 前 面 代码 生成 结果 的 反 编 译 代 码 。 清 晰 起 见 ， 我 把 
Main 方 法 、 类 定义 的 环境 上 下 文 也 加 了 进来 。 

代码 清单 4-9 两 行动 态 操作 的 反 编 译 结 

using Microsoft.CSharp.RuntimeBinder,; 


using System; 
Using System.Runtime.CompilerServices; 


class DynamicTypingDecompiled 
private static class CallSites <------ 缓存 调用 位 置 


public static CallSite<Func<CallSite, object, int, object 
method; 

public static CallSite<Func<CallSite, object, string>> 
conversion; 


static void Main() 

















{ 
object text = "hello world"; 
if (CallSites.method == nyull) <------ 根据 需要 为 方法 创建 调用 1 
{ 
CSharpArgumentInfo[] argumentInfo = new[] 
CSharpArgumentInfo.Create( 
cSharpArgumentInfoFlags.None, null), 
CSharpArgumentInfo.Create( 
cSharpArgumentInfoFlags.Constant | 
cSharpArgumentInfoFlags.UseCompileTimeType, 
null) 
}; 
CcallSiteBinder binder = 
Binder.InvokeMember(CSharpBinderFlags.None, "Substrin 
null, typeof(DynamicTypingDecompiled), argumentInfo 
CallSites.method = 
CallSite<Func<CallSite, object, int, object>>.Create( 
上 
if (CallSites.conversion == nyull) <------ 根据 需要 为 转换 创建 
CcallSiteBinder binder = 
Binder.Convert(CSharpBinderFlags.None, typeof(string) 
typeof (DynamicTypingDecompiled ) ) ; 
CallSites.conversion = 
CallSite<Func<CallSite, object, string>>.Create(binde 
} 


object result = CallSites,.method,.Target( (本 行 及 以 下 1 行 ) 调 . 
CallSites.method, text, 6); 


string str = <------ 调 起 转换 调用 位 置 
CallSites.conversion.Target(CallSites.conversion, resul 


} 
} 


对 于 上 面 糟糕 的 代码 格式 还 请 见谅 ， 虽 然 我 已 经 竭尽 所 能 增强 代码 
的 可 读 性 ， 但 依然 无 法 避免 那些 长 名 称 的 变量 。 不 过 还 好 ， 如 果 不 
是 兴趣 驱动 ， 基 本 上 没有 必要 研究 这 类 代码 。 需 要 注意 ，callsite 
位 于 System.Runtime .Compilerservices 命 名 空间 下 ， pd 
无 天 的 类 型 ， 而 Binder 类 则 位 于 Microsoft.cSharp.RuntimeBinder 


下 5 














代码 中 涉及 了 很 多 call site。 每 个 call site 都 由 生成 代码 所 缓存 ，DLR 
中 也 存在 多 级 缓存 机 制 。 上 述 过 程 也 涉及 绑 定 操作 。 在 call site 中 组 
存 每 步 绑 定 的 结果 可 以 提升 效率 ， 因 为 当 调用 之 间 的 上 下 文 发 生 了 
变化 ， 即 使 是 同一 个 方法 调用 ， 最 终 得 到 的 绑 定 结果 也 可 能 不 同 。 


以 上 代码 最 终 得 到 的 是 一 个 超级 遍 效 的 系统 。 动 态 类 型 在 效率 上 虽 
然 还 不 及 静态 类 型 ， 但 已 经 接近 了 。 我 认为 在 需要 使 用 动态 类 型 的 
大 部 分 场景 中 ， 其 性 能 问题 不 会 成 为 制约 因素 。 下 面 总 结 动态 类 型 
的 一 些 局 限 以 及 适用 场景 。 


4.1.4 ”动态 类 型 的 局 限 与 意外 


一 门 语言 ， 如 果 在 诞生 之 初 束 设计 为 静态 语言 ， 是 很 难为 其 集成 动态 类 
型 的 。 很 自然 地 ， 在 茶 些 情况 下 二 者 无 法 很 好 地 融合 。 我 总 结 了 一 张 清 
单 ， 罗 列 了 动态 类 型 的 局 限 以 及 在 执行 期 的 意外 行为 。 这 张 清单 虽然 无 
法 穷尽 所 有 情况 ， 但 已 经 圳 括 大 部 分 常见 问题 。 


1. 动态 类 型 与 泛 型 


动态 类 型 与 泛 型 搭配 使 用 很 有 意思 。 编 译 时 使 用 dynamic 有 如 下 规 
则 : 


o 类 型 所 实现 的 接口 中 不 能 有 dynamic 类 型 实 参 ; 
在 类 型 约束 中 不 能 使 用 dynamic; 
o 一 个 类 的 基 类 可 以 有 dynamic 的 类 型 实 参 ， 该 类 型 实 参 可 以 蔡 




















O 〇 





套 在 另 一 接口 内 ; 
o dynamic 可 以 用 作 变 量 的 接口 类 型 实 参 。 
下 列 声 明 均 非法 : 


class DynamicSequence : IEnumerable<dynamic> 

class DynamicListSequence : IEnumerable<List<dynamic>> 

class DynamicConstraint1<T> : IEnumerable<T> where T : dynami 
class DynamicConstraint2<T> : IEnumerable<T> where T : List<d 


以 下 声明 均 合法 : 


class DynamicList : List<dynamic> 
class ListOfDynamicSequences : List<IEnumerable<dynamic>> 
IEnumerable<dynamic> x = new List<dynamic> { 1, 0.5 }.Select( 


2. 扩展 方法 


执行 期 的 绑 定 器 不 能 处 理 扩展 方法 。 从 原理 上 讲 ， 执 行 期 绑 定 器 是 
可 以 处 理 扩展 方法 的 ， 但 如 果 这 么 做 ， 它 需要 在 每 个 call site 都 保存 
所 有 using 指 令 的 相关 附加 信息 。 不 过 这 并 不 影响 在 类 型 实 参 中 使 
用 动态 类 型 的 情况 ， 因 为 这 还 是 属于 静态 绑 定 调用 的 范畴 。 代 码 清 
单 4-10 中 的 编译 和 运行 都 没有 问题 。 


代码 清单 4-10 在 动态 值 列 表 执 行 LINQ 


List<dynamic> Source = new List<dynamic> 


{ 








5, 
2.75, 
TimeSpan.FromSeconds(45) 


IEnumerable<dynamic> query = source.Select(x => x * 2); 
foreach (dynamic value in query) 


Console.writeLine(value); 





这 里 仅 有 的 动态 操作 就 是 x * 2 和 console.writeLine 的 重 载 决 
议 。select 方 法 调用 依然 是 编译 时 绑 定 。 下 面 把 它 变 成 动态 的 ， 并 
简化 成 只 调用 Any() 扩 展 方 法 。 “如果 还 是 调用 Select 方 法， 会 遇 
到 另 一 个 问题 ， 稍 后 介绍 。) 修改 后 的 代码 如 下 所 示 。 

代码 清单 4-11 在 动态 目标 上 调用 扩展 方法 


dynamic source = new List<dynamic> 





5S, 
2.75, 
TimeSpan.FromSeconds(45) 


bool result = source.Any(); 


这 上段 代码 未 展示 输出 结果 ， 因 为 它 根 本 不 会 输出 结果 。 它 会 抛 出 一 
个 RuntimeBinderException， 因 为 List<T> 没 有 Any 这 样 一 个 扩展 方 


A 

如 果 还 想 让 扩展 方法 的 调用 目标 看 起 来 像 动态 值 ， 可 以 像 普 通 静 态 
方法 调用 那样 操作 。 例 如 代码 清单 4-11 的 最 后 一 行 可 以 改写 为 : 
bool result = Enumerable.Any(source); 

该 调用 的 绑 定 依然 发 生 在 执行 期 ， 但 仅 涉及 重 载 决 议 。 

. 匿名 函数 


动态 类 型 在 匿名 函数 的 应 用 上 存在 3 项 限制 。 方 便 起 见 ， 下 面 都 使 
用 lambda 表 达 式 来 举例 。 


首先 ， 匿 名 方法 不 能 赋值 给 dynamic 类 型 的 变量 ， 因 为 编译 器 不 能 
确定 应 该 创建 哪个 类 型 的 委托 。 例 如 以 下 代码 非法 : 

dynamic function = x => x * 2; 
Console.writeLine(function(0.75)); 

不 过 有 一 种 迁 回 的 方法 : 先 赋值 给 或 者 转换 成 一 个 中 间 的 静态 变 
量 ， 然 后 把 静态 值 赋 给 动态 值 ， 这 样 就 可 以 实现 委托 的 动态 调用 
了 ， 因 此 以 下 代码 是 可 行 的 ， 并 最 终 打 印 出 结果 1.5。 





dynamic function = (Func<dynamic, dynamic>) (x => x * 2) 
Console.writeLine(function(0.75)); 


其 次 ，lambda 表 达 式 也 不 能 出 现在 需要 动态 绑 定 的 操作 中 ， 原 因 同 
上 。 这 也 是 代码 清单 4-11 中 不 能 用 select 来 展示 扩展 方法 的 原因 ， 
理 则 代码 清单 4-11 的 代码 束 可 以 改写 如 下 : 


dynamic source = new List<dynamic> 


{ 








5， 
2.75, 
TimeSpan.FromSeconds(45) 


了 
dynamic result = source.Select(x => x * 2); 


以 上 代码 在 执行 期 会 执行 失败 ， 因 为 无 法 查找 到 select 扩 展 方法 。 
其 实 它 根本 无 法 通过 编译 ， 束 是 因为 使 用 了 lambda 表 达 式 。 解 决 编 





译 问 题 的 方法 与 前 面 一 样 : 把 lambda 表 达 式 先 赋值 给 静态 变量 或 者 
转换 成 委托 类 型 。 虽 然 执行 期 查找 不 到 Select 扩展 方法 还 是 会 失 

败 ， 但 如 果 调 用 类 似 于 List<T>.Find 这 样 的 一 般 方 法 还 是 没有 问题 
的 。 


最 后 ， 需 要 转换 成 表达 式 树 的 lambda 表 达 式 ， 不 能 包含 任 

何 dynamic 操 作 。 这 一 点 听 起 来 有 些 奇怪 ， 因 为 DLR 内 部 就 有 使 用 
表达 式 树 。 不 过 在 实际 使 用 中 ， 这 并 不 算 什 么 问题 。 大 部 分 情况 
傅 。 


下 面 修改 代码 清单 4-10， 使 用 静态 类 型 source 变 量 ， 使 
用 IQueryable<T>。 


代码 清单 4-12 ”在 IQueryable<T> 中 使 用 动态 元 素 类 型 


List<dynamic> source = new List<dynamic> 





5S, 
2.75, 
TimeSpan.FromSeconds(45) 


}; 
IEnumerable<dynamic> query = source 
.AsQueryable() 
.Select(x => x * 2); <------ 这 名 代码 现在 不 能 通过 编译 


AsQueryable() 方 法 调用 的 结果 是 IQueryable<dynamic> 类 型 的 。 访 
类 型 属于 静态 类 型 ， 但 是 select 方 法 接收 表达 式 树 而 不 是 委托 ， 即 
lambda 表 达 式 (x => x * 2) 会 转化 成 表达 式 树 ， 但 它 执 行 的 是 一 个 
动态 操作 ， 所 以 在 编译 时 就 报错 了 。 


. 匿名 类 型 


之 前 讲 匿名 类 型 时 ， 曾 提 过 这 个 问题 ， 在 此 重申 : 匿名 类 型 在 C# 顷 
译 时 生成 的 开 代 码 与 普通 类 是 相同 的 。 匿 名 类 型 的 访问 权限 是 
internal， 上 所 以 匿名 类 型 所 在 的 程序 集 之 外 是 不 可 访问 的 。 这 样 的 设 
计 通 第 不 会 导致 什么 问题 ， 因 为 匿名 类 型 通常 只 在 单个 方法 中 使 
用 ; 但 有 了 动态 类 型 ， 就 可 以 访问 匿名 类 型 实例 的 属性 了 《代码 必 
须 有 生成 类 的 访问 权限 ) 。 以 下 代码 示例 是 合法 的 : 














代码 清单 4-13 ”动态 访问 匿名 类 型 的 属性 
static void PrintName(dynamic obj ) 


Console.writeLine(obj.Nanme); 


static void Main() 


var x = new { Name 
var y = new { Name 
PrintName(x); 
PrintName(y); 


"Abc" } 
"Def", Score = 10 }; 


以 上 代码 共 包 含 两 个 匿名 类 型 ， 绑 定 过 程 并 不 会 在 意 绑 定 的 对 象 是 
否 为 匿名 类 型 ， 不 过 绑 定 期 间 会 检查 它 是 售 拥 有 对 属性 的 访问 权 

限 。 如 果 把 这 两 段 代码 拆 分 到 两 个 程序 集中 ， 束 会 出 现 问 题 。 绑 定 
器 会 发 现 它 即将 访问 的 匿名 类 型 仅 对 其 所 在 的 程序 集 可 见 ， 然 后 抛 
出 RuntimeBinderException。 要 解决 这 个 问题 ， 可 以 使 

用 [InternalsvisibleTo] 来 让 程序 集 在 绑 定 时 可 以 访问 匿名 类 型 创 
建 时 所 在 的 程序 集 ， 这 也 不 失 为 一 个 不 错 的 方式 。 


. 显 式 的 接口 实现 

执行 期 绑 定 器 使 用 的 是 动态 值 的 执行 期 类 型 ， 然 后 以 静态 变量 值 的 
绑 定 方式 来 执行 绑 定 ， 然 而 在 处 理 显 式 接口 实现 这 个 C# 现 有 特性 
时 ， 就 出 现 问题 了 。 当 使 用 显 式 接口 实现 时 ， 实 现 的 成 员 只 在 使 用 
接口 视图 时 才 是 可 用 的 ， 而 不 能 使 用 类 型 本 号 。 

空 口 解 释 比 较 费 劲 ， 下 面 以 List<T> 为 例 来 说 明 。 

代码 清单 4-14” 显 式 接口 实现 的 例子 


List<int> list1 = new List<int>(); 
Console.writeLine(list1.IsFixedSize); <------ 编译 时 错误 








IList list2 = list1; 
Console.writeLine(list2.IsFixedSize); <------ 成 功 。 打 印 False 


dynamic list3 = list1; 
Console.WriteLine(1list3.IsFixedSize); <------ 执行 期 错误 





List<T> 实 现 了 IList 接 口 。 访 接口 有 一 个 名 为 IsFixedSize 的 属 

性 ，List<T> 显 式 实现 了 该 属性 。 任 何 静 态 List<T> 对 象 ， 如 果 试 图 
通过 表达 式 访 问 该 属性 ， 在 编译 时 就 会 报错 ， 但 是 可 以 通过 IList 
声明 的 变量 来 访问 该 属性 ， 且 该 属性 总 是 返回 false。 如 果 是 动态 
访问 呢 ? 绑 定 堪 总 是 使 用 该 动态 值 的 具体 类 型 进行 绑 定 ， 所 以 访问 
仍 会 失败 并 抛 出 RuntimeBindeException。 解 决 办 法 是 把 该 动态 类 型 
转换 为 接口 类 型 〈 通 过 类 型 转换 或 者 借助 一 个 新 变量 ) 。 


可 以 肯定 的 是 ， 每 天 和 动态 类 型 打交道 的 人 都 能 举 出 一 大 堆 模 棱 两 
可 的 极端 案例 。 不 过 经 过 以 上 讨论 ， 相 信 读 者 遇 到 这 些 情况 也 不 会 
太 过 惊异 了 。 下 面 介绍 使 用 动态 类 型 的 场合 与 方式 。 











4.1.5 动态 类 型 的 使 用 建议 


总 体 上 讲 ， 我 目 己 并 不 是 动态 类 型 的 拥 征 ， 已 记 不 清 最 后 一 次 在 产品 中 
使 用 动态 类 型 是 什么 时 候 了。 如 果 确 实 需 要 使 用 动态 类 型 ， 我 一 般 会 小 











心 翼 翼 反复 做 好 功能 测试 和 性 能 测试 。 
我 更 青睐 静态 类 型 ， 个 人 经 验 所 见 ， 静 态 类 型 有 如 下 4 大 优势 ， 


使 用 静态 类 型 ， 可 以 更 早 地 发 现 许多 错误 一 一 在 编译 时 发 现 而 不 是 
等 到 执行 期 。 这 一 点 对 于 那些 很 难 进行 穷 举 测试 的 代码 路 径 来 说 万 
了 王 


> 

编辑 器 可 以 上 自动 补 全 代码 。 代 码 目 动 补 全 其 实 对 打字 速度 的 帮助 有 
限 ， 但 它 对 提示 程序 员 下 一 步行 为 有 重要 作用 ， 对 于 使 用 不 太 郊 悉 
的 类 型 来 说 尤其 如 此 。 如 今 编 辑 器 对 于 动态 语言 也 能 提供 相当 不 错 
的 代码 补 齐 功能 ， 但 是 准确 度 还 远 不 如 静态 语言 ， 因 为 可 获取 的 信 
恩 相 对 有 限 。 

静态 类 型 可 以 驱动 开发 人 员 思 考 API 的 设计 ， 比 如 参数 、 返 回 值 
等 。 当 接收 参数 和 返回 值 的 类 型 确定 之 后 ， 就 相当 于 现成 的 文档 
ER 
有 等 。 

静态 类 型 的 处 理工 作 是 在 编译 时 而 非 执 行 期 完成 的 ， 因 此 静态 类 型 
的 执行 效率 更 高 。 不 过 ， 现 代 的 运行 时 机 制 已 经 十 分 强大 ， 这 一 点 
不 必 过 分 强调 ， 但 确实 是 值得 考量 的 一 点 。 




















毋庸 置疑 ， 动 态 类 型 的 忠实 粉丝 同样 可 以 列举 出 动态 类 型 的 诸多 优势 ， 


只 可 惜 我 非 此 道中 人 。 我 认为 ， 如 果 一 门 语言 从 诞生 之 初 就 设计 成 动态 
类 型 语言 ， 那 么 这 些 优势 会 更 容易 获得 。C# 主 体 还 古 一 门 静 态 类 型 语 
言 ， 因 此 才 会 有 前 文 所 说 的 那些 极端 案例 的 遗留 产物 。 下 面 就 何 时 使 用 
动态 类 型 给 出 一 些 相关 建议 。 
1. 处 理 反 射 更 简单 
假设 需要 使 用 反射 来 访问 东 个 属性 或 方法 ， 而 且 我 们 在 编译 时 能 够 
知道 该 属性 或 方法 的 名 字 ， 但 由 于 茶 些 原因 无 法 获取 筷 的 静态 类 
型 ， 这 时 使 用 动态 类 型 让 执行 期 绑 定 需 来 执行 获取 操作 要 比 通过 反 
射 API 获 取 容 易 得 多 。 当 需要 执行 多 步 反 射 操作 时 ， 动 态 类 型 融 来 
的 便利 性 会 更 显著 ， 参 考 以 下 代码 : 


dynamic value = ...; 
value.SomeProperty.SomeMethod( ); 


而 如 果 采 用 反射 方式 ， 将 涉及 如 下 过 程 : 
(1) 根据 初始 值 的 类 型 获取 propertyInfo; 
(2) 获取 该 属性 的 值 并 保存 ; 
(3) 根据 属性 获取 结果 的 类 型 ， 获 取 MethodInfo; 
(4) 执行 该 方法 。 
考虑 到 还 需要 添加 校 验 代码 来 检查 属性 和 方法 是 否 存在 ， 代 码 的 行 
数 就 不 止 一 行 了 。 其 结果 就 是 不 仅 没有 比 动态 方式 更 安全 ， 代 码 的 
可 读 性 反而 变 差 了 。 

2. 处 理 共 有 成 员 但 不 共有 接口 的 情况 
有 时 对 于 一 个 值 ， 我 们 会 预先 知道 它 所 有 可 能 的 类 型 ， 并 不 需要 访 
问 这 些 类 型 的 同名 成 员 。 如 果 这 些 类 型 都 实现 自 同一 个 接口 或 者 继 
承 自 同一 个 基 类 ， 它 们 的 接口 或 基 类 都 声明 了 该 成 员 ， 那 么 一 切 安 
好 。 可 是 现实 往往 不 会 这 么 理想 。 如 果 这 些 类 型 的 同名 成 员 都 是 独 
立 声明 的 呢 《〈 假 设 也 不 能 修改 ) ? 那 就 比较 麻烦 了 。 
虽然 不 会 用 到 反射 ， 但 需要 重复 执行 类 型 检查 、 类 型 转换 ， 然 后 才 























能 访问 到 成 员 。C# 7 提供 的 模式 可 以 大 幅 简 化 该 过 程 ， 但 依然 无 法 
完全 避免 重复 性 工作 。 这 时 就 应 该 使 用 动态 类 型 了 ， 动 态 类 型 能 够 
传递 出 “请 相信 我 ， 即 使 无 法 通过 静态 的 方式 表达 ， 但 我 可 以 确定 
当前 成 员 一 定 存在 ?的 意图 。 在 测试 工程 中 ， 我 倾 问 于 使 用 动态 类 
型 (出 错 的 代价 无 非 是 测试 失败 而 已 ); 而 在 产品 代码 中 ， 我 会 更 
说 惯 地 使 用 动态 类 型 。 


3. 使 用 为 动态 类 型 构建 的 库 


.NET 的 生态 系统 十 分 繁荣 并 且 在 日 益 半 大。 各 路 开发 人 员 开 发 了 各 
种 有 趣 的 库 ， 其 中 一 些 库 乐于 接纳 动态 类 型 。 设 想 有 一 个 库 ， 它 被 
设计 成 提供 更 简单 的 REST 原 型 设计 ， 或 者 是 无 顷 生 成 代码 、 基 于 
RPC 的 API。 这 些 库 对 于 开发 初期 工作 会 很 有 帮助 ， 因 为 在 创建 静 
态 类 型 库 之 前 可 以 保证 开发 工作 顺利 开展 。 


这 有 点 类 似 于 之 前 的 Json.NET 的 例子 。 我 们 可 以 等 到 数据 模型 完全 
定义 好 之 后 再 编写 表示 这 些 数据 模型 的 类 ， 但 在 原型 设计 阶段 ， 把 
JSON 及 其 访问 代码 改 成 动态 方式 会 更 简便 。 与 之 类 似 ， 之 后 还 会 
介绍 COM 组 件 的 改进 方式 。 通 过 这 种 改进 ， 就 能 使 用 动态 类 型 取 
代 烦 琐 的 类 型 转换 操作 了 。 


总 而 言 之 ， 当 使 用 静态 类 型 比较 简单 时 ， 应 当 使 用 静态 类 型 。 在 东 
些 场景 中 ， 也 可 以 考虑 使 用 动态 类 型 。 读 者 应 当 根 据 实际 情况 来 衡 
量 采 用 动态 类 型 的 得 失 ， 例 如 有 些 可 以 用 于 测试 或 原型 设计 的 代码 
并 不 一 定 适 用 于 产品 级 代码 。 


抛 开 那些 为 了 专业 目的 而 编写 的 代码 不 谈 ， 光 是 通过 

Dynamicobject 或 IDynamicMetaobjectProvider 来 实现 啊 应 动态 行为 
这 样 的 能 力 ， 残 能 让 我 们 在 探求 开发 乐趣 的 过 程 中 大 开眼 界 。 无 论 
我 个 人 有 多 刻意 避免 使 用 动态 类 型 ， 但 它 本 喘 优 恨 的 设计 和 在 C# 中 
的 应 用 ， 确 实 为 日 后 的 探索 提供 了 许多 可 能 。 


接 下 来 要 介绍 的 特性 与 动态 类 型 有 所 不 同 ， 不 过 它们 部 将 为 COM 


互 操 作 性 添 砖 加 了 所。 下 面 回 到 静态 类 型 这 一 话题 ， 了 解 它 的 一 个 侧 
面 : 为 形 参 指定 实 参 。 


4.2 可 选 形 参 和 命名 实 参 












































可 选 形 参 


自 . 


和 命名 实 参 的 作用 域 有 限 : 对 于 茶 个 方法 、 构 造 问 、 索 引 右 或 
委托 ， 如 何 为 调用 提供 实 参 ” 可 选 形 参 
参 。 使 用 命名 实 参 


能 够 让 调用 方 完全 省 略 某 个 实 
， 调 用 方 可 以 回 编译 器 或 代码 阅读 者 提供 更 清晰 的 信 





4D。 


当前 实 参与 哪个 形 参 相关 联 。 


下 和 面 通过 举例 来 深入 探究 
他 也 可 能 包含 


4.2.1 和 带 默 认 值 的 形 参 


4 口 


其 细 市 。 这 部 分 只 针对 方法 进行 探讨 ， 对 于 其 
参数 的 成 员 ， 我 们 也 只 针对 方法 进行 探讨 。 


和 带 名 字 的 实 参 








代码 清单 4-15 中 有 一 个 简单 的 方法 ， 该 方法 包含 三 个 参数 ， 其 中 两 个 都 

是 可 选 形 参 。 后 面 几 种 调用 方式 展示 了 不 同 的 特性 。 

代码 清单 4-15 ”可 选 形 参 的 调用 方法 

static void Method(int x, int y = 5, int z = 10) <------ 一 个 必要 形 
Console.WriteLine("x={0}; y={1}; z={2}", xX, Yy, 2Z); <------ 打 [ 


Method(1, 
Method(x: 
Method(z: 
Method(1, 
Method(1, 
Method(1, 


Method(1); < 


Method(x: 


1); 





图 4-2 展 示 了 该 方法 和 一 个 方法 调用 ， 用 于 解释 相关 术语 。 





图 4-2 ”可 选 形 参 / 必 要 形 参 与 命名 实 参 /定位 实 参 的 语法 
涉及 的 语法 比较 简单 。 


。 a i A ,0 
参 。 ee 有 并 你 隐 有 次 他 

。 对 于 实 参 ， 实 参 可 以 在 实 参 值 前 面 使 用 :为 其 指定 参数 名 称 。 不 指 
定名 称 的 实 参 被 和 尔 为 定位 实 参 。 


形 参 的 默认 值 必须 是 以 下 表达 式 之 一 。 


。 编译 时 的 常量 值 ， 比 如 数值 、 字 符 串 或 者 nul1。 

e。 default 表 达 式 ， 例 如 default(CancellationToken)。14.5 节 会 讲 
到 ，C# 7.1 引 入 了 default 语 法 ， 束 可 以 直接 使 用 default 而 不 需要 
default(CancellationToken) 了 。 

enew 表 达 式 ， 例 如 new Guid() 或 者 new CancellationToken(),， 各 部 


对 值 类 型 有 效 。 


lr 之 后 ， 形 参数 组 除外 〔( 形 参数 组 是 使 
用 params 修 饰 符 修饰 的 形 参 











警告 ”虽然 把 可 选 形 参 放 在 形 参数 组 前 是 合法 的 ， 但 在 调用 时 这 种 
写法 会 引起 混淆 。 建议 避免 这 种 写法 ， 关 于 这 类 调用 的 处 理 方式 ， 
本 书 不 会 细 谈 。 


把 参数 设 为 可 选 ， 是 为 了 当 调 用 实 参 的 值 与 默认 值 一 样 时 ， 可 以 省 略 该 
实 参 。 下 面 介绍 编译 器 是 如 何 处 理 默 认 形 参 和 命名 实 参 的 。 


4.2.2 如何 诀 定 方 法 调用 的 含义 


如 末 读 者 阅读 过 语 语 规范， 不 会 发 现 决 定 实 参 与 形 参 对 应 关系 的 过 程 ， 
实际 上 属于 重 载 决议 的 一 部 分 ， 而 且 与 类 型 推断 关联 紧密 ， 但 这 部 分 内 
容 比较 复杂 ， 所 以 这 里 将 其 简化 ， 重点 关注 假设 已 经 完 成 重 载 决 议 的 音 
个 方法 ， 介 绍 如 下 。 


其 中 的 规则 不 难 列 出 。 


。 所 有 定位 实 参 必 须 位 于 所 有 命名 实 参 之 前 。 这 条 规则 在 C# 7.2 之 后 
有 所 放宽 ? 详 见 14. 6 节 。 

。 定位 实 参与 对 应 的 形 参 在 方法 签名 中 的 位 置 总 是 相同 的 。 第 一 个 定 
人 ， 第 二 个 定位 实 参 对 应 第 二 个 形 参 ， 以 此 类 

。 命名 实 参 依照 名 字 与 形 参 进行 对 应 : 名 为 x 的 实 参 ， 对 应 名 为 x 的 形 
参 。 命 名 实 参 不 受 顺 序 限制 。 

。 任何 形 参 都 只 能 对 应 唯一 的 实 参 。 不 能 出 现 同 名 的 命名 实 参 ， 也 不 
能 使 用 命名 实 参 抢占 已 经 有 对 应 实 参 的 定位 形 参 。 

。 所 有 必要 形 参 都 必须 有 对 应 的 实 参 来 提供 值 。 

。 可 选 形 参 可 以 没有 对 应 的 实 参 ， 此 时 会 由 编译 器 负责 提供 默认 值 来 
作为 相应 实 参 。 


再 看 一 下 前 面 例子 中 的 一 个 方法 调用 : 
static void Method(int x, int y = 5, int z = 10) 


x 征 必要 形 参 ， 因 为 它 没有 默认 值 ， 而 y 和 z 都 是 可 选 形 参 。 表 4-1 展 示 了 
一 些 合法 的 调用 以 及 对 应 的 执行 结果 。 


表 4-1 使 用 命名 实 参 和 可 选 形 参 的 一 些 调 用 示例 
[人 人 





























全 部 是 定位 实 参 ， 属 于 C# 4 之 前 的 利 规 调 
用 方 起 


N~< xXx 
I 
C 记忆 


~ 


因为 y 和 z 没 有 实 参 ， 所 以 由 编译 器 为 二 者 
提供 实 参 


I 1 
op 
OO~: 


非法 ， 因 为 x 没有 提供 实 参 


非法 ， 因 为 x 没有 提供 实 参 


非法 ， 因 为 没有 为 x 提供 实 参 ， 由 编译 器 
为 y 提 供 默 认 值 ，z 属 于 命名 实 参 ， 所 以 y 等 
于 被 跳 过 了 


和 
了 
时 


1 
5) 
3 


N~<= x 
I II 


非法 ， 因 为 x 对 应 了 两 个 实 参 


非法 ， 因 为 y 对 应 了 两 个 实 参 


= ~ 


为 命名 实 参 不 受 顺 序 限制 


N~< Xx 
I 
ODP 








在 处 理 方法 调用 时 ， 有 两 点 需要 重点 关注 。 首 先 ， 在 方法 调用 中 ， 实 参 








会 按照 在 源码 中 出 现 的 顺序 从 左 到 右 依次 被 运算 。 这 一 扣 在 多 数 情况 下 
都 无 关 紧 要 ， 但 是 如 果实 参 的 运算 有 副作用 ， 束 会 产生 后 果 了 。 考 虑 以 
下 两 个 方法 调用 : 


int tmp1i = 0; 
Method(x: tmpi++, y: tmpi++, ZzZ: tmpi++); <------ x=0; y=1; Z=2 


int tmp2 = 0; 
Method(z: tmp2++, y: tmp2++, x: tmp2++); <------ x=2; y=1; z=0 











两 个 方法 调用 的 唯一 差别 是 命名 实 参 的 顺序 。 正 是 因为 顺序 不 同 ， 导 致 
最 终 传 入 实 参 的 值 不 同 ， 而 且 这 两 种 代码 的 可 读 性 都 不 太 强 。 当 实 参 运 
算 的 副作用 关乎 调用 结果 时 ， 建 议 单独 运算 每 个 实 参 ， 把 它们 赋值 给 局 
部 变量 ， 然 后 把 这 些 局 部 变量 直接 作为 实 参 传递 : 


int tmp3 





0 日 


= 了 
int argX = tmp3++; 
int argY = tmp3++; 
int argZ = tmp3++; 


Method(x: argX, y: argY, z: argZ) 


通过 这 种 方式 ， 不 管 采 用 命名 实 参 还 是 定位 实 参 ， 都 不 会 影响 方法 的 调 
用 行为 ， 可 以 根据 可 读 性 的 强 弱 目 由 选择 。 把 实 参 运算 和 方法 调用 分 离 
开 来 ， 可 以 让 运算 顺序 变 得 更 清晰 易 懂 。 


其 次 ， 如 采 由 编译 器 为 形 参 提 供 默认 值 ， 那 么 这 些 值 是 众 在 它 所 生成 苇 
代码 中 的 。 编 译 器 需要 为 其 指定 默认 值 ， 而 不 是 等 到 执行 期 才 确 定 。 因 
nn 
工 No 


4.2.3 ”对 版 本 号 的 影响 


对 于 公共 API 来 说 ， 版 本 写 的 制定 是 一 个 令 人 头疼 的 问题 ， 难 以 做 到 界 
限 分 明 。 昌 然 语义 版 本 规则 要 求 任何 破坏 性 改动 都 需要 更 新 主 版 本 号 ， 
可 是 如 果 考 虑 到 各 种 模糊 案例 ， 对 于 那些 依赖 于 某 个 库 的 代码 ， 几 乎 任 
何 改 动 都 可 以 算 作 破 坏 性 改动 。 因 此 ， 就 制定 版 号 本 来 说 ， 可 选 形 参 和 
命名 实 参 的 使 用 是 比较 困难 的 。 下 面 看 几 种 实际 情况 。 


1. 参数 名 称 的 改变 具有 破坏 性 























假设 有 一 个 库 ， 库 中 包含 某 个 公共 方法 : 
public static Method(int x, int y = 5, int z = 10) 
如 果 在 新 版 本 中 做 如 下 改动 : 


public static Method(int a, int b = 5, int c = 10) 


上 述 改 动 束 具有 破坏 性 的 。 那 些 使 用 命名 实 参 的 方法 调用 代码 都 失 
效 了 ， 因 为 它们 所 指定 的 参数 名 已 经 不 存在 了 。 请 记 住 ， 任 何 时 候 
对 参数 名 的 检查 都 要 像 对 符 类 型 和 成 员 名 那样 仔细 。 





. 默认 值 的 改动 也 会 有 意外 影响 


前 面 说 过 ， 默 认 值 是 编译 器 在 开 代 人 码 对 方法 的 调用 中 就 已 经 确定 的 
值 。 在 同一 个 程序 集 下 ， 默 认 值 的 改动 不 会 引发 问题 。 如 果 是 不 同 
程序 集 ， 只 有 将 调用 代码 重新 编译 才能 便 改 动 后 的 堆 认 值 重 新 生 


效 。 


如 果 可 以 预知 需要 改动 默认 值 ， 那 么 可 以 在 文档 中 明确 通知 大 家 ， 
这 种 做 法 也 算 合情合理 。 但 还 是 无 法 避免 会 有 某 些 调用 方 被 这 一 改 
动 搞 得 狸 不 及 防 ， 尤 其 是 包含 某 些 复杂 依赖 链 时 。 规 避 该 问题 的 一 
种 方法 是 ， 使 用 一 个 专用 的 默认 值 ， 该 默认 值 总 是 让 方法 在 执行 期 
自行 选取 值 。 例 如 对 于 某 个 int 类 型 的 参数 ， 就 可 以 改 

用 Nullable<int>， 这 样 该 参数 的 默认 值 就 为 uw11， 然 后 方法 就 有 了 
自主 选择 权 。 之 后 就 算 方法 实现 发 生变 动 ， 但 每 个 使 用 了 新 版 本 的 
调用 方 ， 都 会 自动 获得 新 的 行为 ， 无 须 重 新 编译 。 

















. 添加 重 载 方法 很 棘手 


在 单一 版 本 的 情况 下 ， 重 载 决 议 是 很 困难 的 事情 。 添 加 重 载 方法 同 
时 不 对 任何 代码 造成 破坏 则 是 难 上 加 难 ， 因 此 原 有 的 方法 签名 都 必 
须 出 现在 新 版 本 中 ， 这 样 才 不 会 破坏 二 进 制 文件 的 兼容 性 ， 同 时 要 
保证 所 有 原 有 方法 的 调用 ， 其 重 载 决议 结果 与 先前 保持 一 致 ， 或 者 
至 少 能 决议 到 等 价 的 方法 中 。 形 参 是 人 否 为 可 选 形 参 ， 并 不 属于 方法 
签名 的 一 部 分 : 将 形 参 改 为 可 选 或 不 可 选 ， 并 不 会 破坏 代码 的 二 进 
制 兼 容 性 ， 但 可 能 会 破坏 源头 的 兼容 性 。 如 果 在 引入 重 载 方法 时 不 











够 仔细 ， 添 加 了 茶 个 具有 更 多 可 选 形 参 的 方法 ， 那 么 很 容易 为 重 载 
决议 带 来 不 确定 性 。 


假如 有 两 个 方法 在 重 载 决 议 时 匹配 度 相 当 : 就 调用 而 言 未 有 胜 者 ， 
连 实 形 参 转换 也 势 均 力 政 ， 那 么 只 能 通过 默认 值 的 匹配 度 来 一 较 高 
下 了 。 一 个 没有 可 选 形 参 的 方法 ， 与 一 个 有 可 选 形 参 但 没有 指定 对 
应 实 参 的 方法 相 比 ， 前 者 会 胜出 ; 但 如 果 是 一 个 有 可 选 形 参 但 没有 
指定 对 应 实 参 的 方法 ， 与 一 个 有 两 个 可 选 形 参 但 同样 没有 指定 对 应 
实 参 的 方法 相 比 ， 二 者 不 相 上 下 。 


强烈 建议 尽量 避免 添加 那些 有 可 选 参数 的 重 载 方法 ， 最 好 从 一 开始 
就 在 头脑 中 建立 这 条 准则 。 这 里 提供 一 点 方法 : 对 于 那些 可 能 有 多 
种 参数 选项 的 方法 ， 可 以 创建 一 个 新 类 用 于 表示 这 些 选项 ， 然 后 把 
这 个 类 作为 方法 调用 的 一 个 可 选 参数 。 这 样 当 需 要 动态 添加 新 选项 
时 ， 就 可 以 问 这 个 新 类 添加 更 多 属性 ， 而 不 用 修改 原 方法 的 签名 。 


纵然 限制 重重 ， 我 仍 对 可 选 参数 钟情 不 已 。 这 是 因为 对 于 多 数 稼 规 
情况 来 讲 ， 可 选 参 数 能 够 简化 方法 调用 的 代码 ， 而 且 我 也 偏好 使 用 
命名 实 参 ， 因 为 它 让 调用 代码 的 表意 更 清晰 。 尤 其 当 同 一 类 型 的 多 
个 参数 出 现在 同一 个 方法 中 ， 这 种 情况 更 容易 让 人 混 消 。 例 如 
Windows Forms 的 MessageBox .Show 方法 ， 我 总 是 使 用 命名 实 参 来 进 
行 调用 。 我 也 记 不 清 究 竟 是 消息 box 的 title 在 先 ， 还 是 text 在 先 。 虽 
然 IntelliSense 在 编码 时 可 以 给 出 提示 ， 但 在 阅读 代码 时 ， 还 是 命名 
参数 更 清晰 明了 : 


MessageBox.Show(text: "This is text", caption: "This is the t 


下 一 个 特性 比较 特殊 ， 部 分 读者 极 少 使 用 它 ， 而 男 一 些 读者 使 用 频 
繁 。 昌 然 COM 组 件 这 项 技术 已 经 比较 陈旧 ， 但 目前 依然 存在 于 大 
量 代码 当中 。 


4.3 COM 互 操作 性 提升 


在 C# 4 之 前 ，Visual Basic 语 言 比 C# 更 适合 跟 COM 组 件 交 互 。Visual 

Basic 一 直 以 来 都 是 一 门 比较 易 用 的 语言 ， 它 从 诞生 之 初 就 提供 了 命名 
实 参 和 可 选 形 参 的 特性 。C# 4 的 出 现 则 让 C# 语 言 和 COM 组 件 交 互 变 得 
简单 了 许多 。 如 果 读 者 没有 与 COM 组 件 交 互 的 需要 ， 那 么 可 以 跳 过 本 









































节 内 容 ， 本 布 介绍 的 所 有 特性 都 只 与 COM 组 件 相关 。 


说 明 COM (component object model， 组 件 对 象 模 型 ) 由 微软 于 
1993 年 推出 ， 是 一 种 在 Windows 系 统 上 用 于 互 操作 性 的 跨 语 言 形 
式 。COM 组 件 的 完整 概念 超出 了 本 书 的 探讨 范围 ， 这 里 假定 读者 
己 经 知晓 相关 内 容 。 最 常用 的 COM 库 当 属 Microsoft Office 组 件 。 


首先 要 介绍 的 特性 位 于 语言 层面 之 上 。 该 特性 主要 与 部 署 过 程 相关 ， 男 
外 还 与 如 何 对 外 其 露 操作 相关 。 


4.3.1 链接 主 互 操作 程序 集 


当 针 对 COM 类 型 编程 时 ， 需 要 使 用 该 组 件 库 生 成 的 程序 集 ， 通 常 称 为 
主 互 操作 程序 集 (primary interop assembly，PIA) ， 该 程序 集 由 组 件 发 
布 者 负责 生成 。 我 们 可 以 使 用 类 型 库 导 入 工具 (tlbimp) 来 为 自己 的 
COM 库 生成 PIA。 


在 C# 4 之 前 ， 必 须 在 代码 最 终 运 行 的 机 器 上 部 署 完整 的 PIA， 而 且 部 署 
版 本 要 与 编译 的 版 本 保持 一 致 。 这 样 需 要 将 PIA 和 应 用 程序 一 起 交付 ， 
或 者 目 行 保证 安装 的 PIA 是 正确 的 版 本 。 


自 C# 4 和 Visual Studio 2010 起 ， 对 PIA 的 使 用 就 可 以 从 引用 变 成 链接 方 
式 了 。 该 使 用 方式 可 以 通过 Visual Studio 中 property 页 的 reference 标 签 中 
的 Embed Interop Types 选 项 更 改 。 


将 该 选项 设 为 Ture 后 ， 相 关 的 PIA 部 分 会 被 直接 舱 入 当前 程序 集 ， 并 且 
只 有 应 用 程序 中 用 到 的 部 分 才 会 被 纳入 。 到 了 代码 运行 阶段 ， 客 户 机 上 
的 运行 版 本 与 组 件 的 编译 版 本 是 否 相同 已 经 无 所 请 了 ， 因 为 程序 用 到 的 
那 部 分 代码 已 经 在 编译 时 包含 进来 了 。 图 4-3 是 从 代码 的 运行 角度 看 引 
用 方式 《〈 旧 方式 ) 和 链接 方式 “新 方式 ) 的 区 别 。 

















图 4-3 ”引用 与 链接 的 对 比 


除了 部 署 方式 的 变化 ， 链 接 PIA 也 影响 了 COM 类 型 中 vARIANT 类 型 的 处 
理 方式 。 如 果 PIA 被 引用 ， 所 有 返回 vARIANT 的 操作 都 会 通过 C# 的 object 
类 型 暴露 。 之 后 需要 把 object 类 型 的 返回 值 转换 成 适用 于 方法 和 属性 的 


类 型 。 


如 果 是 链接 方式 的 PIA， 则 会 返回 dynamic 类 型 值 ， 而 不 是 obejct 类 型 

值 。 前 面 讲 过 ，dynamic 类 型 到 任意 非 指针 类 型 都 存在 隐 式 类 型 转换 ， 

参考 以 下 关于 打开 Excel 文 件 并 填充 20 个 数 
示例。 


代码 清单 4-16 ”通过 隐 式 动态 类 型 转换 在 Excel 中 设置 一 组 数据 


var app = new Application { Visible = true }; 

app .workbooks.Add( ) ; 

Worksheet sheet = app.ActiveSheet; 

Range start = sheet.Ccells[1, 11]; 

Range end = sheet.Cells[1, 20]; 

sheet.Range[start, endl].Value = Enumerable.Range(1, 20).ToArray() 


这 上段 代码 其 实 还 隐 舍 了 一 些 接 下 来 要 讲 的 特性 ， 不 过 这 里 先 重 点 关注 

sheet 、start 和 end 的 赋值 。 这 3 个 的 赋值 通常 都 需要 进行 类 型 转换 ， 因 
为 赋 给 它们 的 值 是 object 类 型 的 。 如 果 使 用 的 是 var 或 者 dynamic， 就 不 
需要 为 这 些 变量 指定 静态 类 型 了 ， 而 且 可 以 在 更 多 的 操作 中 使 用 动态 类 








型 。 当 清楚 当前 变量 的 类 型 时 ， 我 比较 倾 癌 于 使 用 静态 类 型 。 一 方面 是 
为 了 执行 隐 式 校 验 ， 男 一 方面 是 为 了 后 续 代 码 可 以 获得 IntelliSense。 


对 于 那些 大 量 使 用 vARIANT 类 型 的 COM 库 ， 这 就 是 动态 类 型 最 重要 的 好 
处 之 一 。 接 下 来 的 这 个 COM 特 性 也 是 基于 C# 4 的 一 个 新 特性 ， 而 且 把 可 
选 形 参 提 升 到 了 一 个 新 高 度 。 

4.3.2 COM 组 件 中 的 可 选 形 参 


部 分 COM 方 法 包含 大 量 参数 ， 而 且 这 些 参数 经 常 是 ref 参 数 。 在 C# 4 之 
前 ， 像 保存 Word 文 档 这 样 的 操作 都 要 大 费 周章 。 


代码 清单 4-17 在 C# 4 之 前 如 何 创建 并 保存 Word 文 档 


object missing = Type.Missing; <------ ref 参 数 的 占 位 变量 








Application app = new Application { Visible = true }; <------ 打开 
Document doc = app.Documents.,Add (本 行 及 以 下 4 行 ) 创建 并 填充 文档 
ref missing, ref missing, 
ref missing, ref missing); 
Paragraph para = doc.Paragraphs.Add(ref missing); 
para.Range.Text = "Awkward old code"; 





object fileName = "demo1.docx"; (本 行 及 以 下 6 行 ) 保存 文档 
doc.SaveAs2(ref fileName, ref missing, 

ref missing, ref missing, ref missing, 

ref missing, ref missing, ref missing, 

ref missing, ref missing, ref missing, 

ref missing, ref missing, ref missing, 

ref missing, ref missing); 


doc.Close(ref missing, ref missing, ref missing); (本 行 及 以 下 2 行 ) 详 


app.Application.Quit( 
ref missing, ref missing, ref missing); 


如 上 所 示 ， 仪 仅 为 了 创建 并 保存 文档 束 需 要 如 此 多 的 代码 ， 而 且 ref 
missing 这 条 语句 出 现 了 20 次 之 多 。 有 如 此 多 的 无 天 参数 林立 于 代码 之 
中 ， 很 难 有 效 找到 那些 有 用 的 代码 。 

C# 4 推出 的 知 干 特性 大 大 简化 了 该 过 程 。 


。 如 前 所 述 ， 使 用 命名 实 参 可 以 让 实 参 与 形 参 之 间 的 对 应 关系 变 得 一 





目 于 和 
。 对 于 ref 参 数 ， 值 可 以 直接 指定 为 实 参 〈 仪 适用 于 COM 库 ) 。 
器 会 在 后 台 为 其 创建 一 个 局 部 变量 ， 然后 将 该 变 晤 所 后 引 用 进行 人 


圳 。 
。 ref 人 参数 可 以 是 可 选 参数 ， 在 调用 代码 中 可 以 省 略 〈 也 仅 适 用 于 
COM 库 ) 。Type.Missing 用 于 表示 默认 值 。 


代码 清单 4-17 可 以 以 更 简洁 的 形式 呈现 ， 参 见 代 码 
清单 4-18。 


代码 清单 4-18 ”使 用 C# 4 创建 和 保存 Word 文 档 


Application app = new Application { 0 = true }; 
Document doc = app.Documents.Add(); <------ 省 略 了 所 有 的 可 选 形 参 








Paragraph para = He a 
para.Range.Text = "Simple new code"; 
doc.SaveAs2(FileName: "demo2.docx"); <------ 使 用 命名 实 参 表意 


doc.Close( ); 
app.Application.Quit(); 


这 种 转变 显著 增强 了 代码 的 可 读 性 。 代 码 中 移 除 了 20 个 ref missing 及 

其 变量 。 我 们 传递 给 savaAs2 的 实 参与 该 方法 的 第 一 个 形 参 相 对 应 。 也 

可 以 使 用 定位 实 参 代 替 命名 实 参 ， 不 过 命名 实 参 在 表意 上 会 更 清晰 。 如 
果 需 要 为 后 面 的 茶 个 形 参 提供 实 参 ， 直接 添加 该 形 参 名 称 以 及 对 应 参数 
值 即 可 ， 其 他 无 天 参 数 可 以 直接 省 略 。 


此 外 ，saveAs2 方 法 还 展示 了 隐 式 ref 的 特性 。 利 用 该 特性 ， 我 们 可 以 在 
源码 层面 直接 传递 值 ， 而 无 须 事先 声明 一 个 变量 保存 demo2.docx 后 再 通 
过 引用 传递 ， 编 译 器 会 把 它 转 换 成 ref 参 数 。 最 后 要 介绍 的 COM 相 关 的 
特性 ，Visual Basic 比 C# 更 显著 。 


4.3.3 ”命名 索引 器 


索引 器 属于 C# 的 “开明 元 老 >， 它 主要 用 于 集合 ， 例 如 通过 索引 从 列表 中 
获取 元 素 ， 或 者 通过 键 从 字典 中 获取 值 ， 不 过 一 直 以 来 C# 中 的 索引 右 在 
源码 中 都 是 不 具名 的 ， 类 型 只 能 拥有 默认 索引 器 (default indexer) 。 我 
们 可 以 通过 attribute 来 指定 一 个 可 以 在 其 他 语言 中 使 用 的 名 字 ， 但 C# 并 
不 允许 通过 名 字 来 区 分 不 同 的 索引 右 ， 至 少 在 C# 4 之 前 是 这 样 的 。 














其 他 一 些 语言 允许 通过 名 字 来 构建 和 使 用 索引 器 ， 这 样 我 们 就 可 以 有 针 
对 性 地 访问 对 象 的 不 同方 面 了 ; 然而 C# 在 常规 代码 中 依然 不 文 持 该 特 
性 ， 但 单独 为 COM 类 型 开 了 一 道 后 门 ， 请 看 示例 。 


Word 中 的 Application 类 型 对 外 提供 了 一 个 名 为 synonymInfo 的 命名 索引 
侨 ， 其 声明 如 下 : 


SynonymInfo SynonymInfo[string Word, ref object LanguageId = Type 


在 C# 4 之 前 ， 需要 像 调 用 一 个 方法 那样 调用 get_synonymInfo， 这 显得 比 
较 奇 怪 ; 到 了 C#4， 束 可 以 通过 名 称 来 访问 了 。 


代码 清单 4-19 访问 命名 索引 器 


Application app = new Application { Visible = false }; 





object missing = Type.Missing; (本 行 及 以 下 1 行 ) 在 C# 4 之 前 访问 synonyms 
SynonymInfo info = app.get_SynonymInfo("method", ref missing); 
Console.writeLine("'method' has {0} meanings", info.MeaningCount) 


info = app.SynonymInfo["index"]; <------ 使 用 命名 索引 器 简化 代码 
Console.writeLine("'index' has {0} meanings", info.MeaningCount); 


以 上 代码 展示 了 命名 索引 器 可 以 像 普通 方法 调用 那样 使 用 可 选 形 参 。C# 
4 之 前 的 代码 需要 声明 一 个 局 部 变量 ， 再 烦 珊 地 以 引用 方式 传递 给 命名 
0 
可 以 省 去 。 


以 上 就 是 C# 4 中 与 COM 组 件 相 关 的 特性 ， 希 望 已 经 阐释 清楚 了 这 些 特性 
的 优势 。 虽 然 我 自己 并 不 常用 COM 组 件 ， 但 倘若 日 后 有 这 方面 的 需 
要 ， 那 么 前 面 这 些 改进 也 会 让 我 的 工作 轻松 许多 。 而 且 由 于 每 个 人 使 用 
的 COM 库 的 结构 不 同 ， 这 些 特 性 所 带 来 的 好 处 也 有 多 有 少 。 例 如 在 需 
要 经 常 使 用 ref 参 数 和 vARIANT 返 回 值 时 ， 它 们 起 到 的 作用 就 远 比 那些 需 
要 很 少 参 数 和 具有 有 具体 返回 类 型 的 库 要 明显 得 多 。 抛 开 这 些 不 谈 ， 光 是 
使 用 链接 的 方式 处 理 PIA 就 足以 让 部 署 过 程 大 大 简化 了 。 


对 C# 4 特性 的 介绍 已 渐 近 尾声 。 最 后 一 个 特性 会 有 些 史 雇 难 懂 ， 不 过 我 
们 通 第 是 在 没有 察觉 的 情况 下 应 用 该 特性 的 。 


4.4 泛 型 型 变 














对 于 泛 型 型 变 ， 举 例 说 明 比 直接 描述 其 概念 要 简单 。 泛 型 型 变 讨 论 的 是 
关于 如 何 根据 泛 型 的 类 型 实 参 对 泛 型 进行 安全 的 类 型 转换 ， 其 中 数据 流 
转 的 方 癌 是 重点 。 


4.4.1 泛 型 型 变 示 例 
首先 还 是 用 一 个 熟悉 的 接口 IEnumerable<T> 为 例 。 访 接口 代表 了 一 个 元 


素 类 型 为 T 的 序列 。 自 然 地 ， 任 何 string 类 型 的 序列 一 定 是 object 类 型 
的 序列 ， 根 据 变 体 规则 : 





IEnumerable<string> strings 
IEnumerable<object> objects 


以 上 代码 看 起 来 是 如 此 的 顺理成章 ， 如 果 它 编译 不 通过 反而 奇怪 了 ， 可 
是 在 C# 4 之 前 ， 这 段 代 码 确 实 不 能 通过 编译 。 


说 明 ”示例 中 会 经 常用 到 string 和 object 这 两 个 类 型 ， 因 为 C# 开 发 
人 员 对 它们 比较 熟悉 ， 所 以 没有 提供 额外 的 上 下 文 。 其 他 具有 基 类 
与 子 类 继承 关系 的 类 型 也 适用 。 


并 非 所 有 直觉 上 可 行 的 代码 就 一 定 行 得 通 ， 对 于 C# 4 也 不 例外 。 下 面 进 
一 步 扩 展 上 述 猜 想 ， 从 序列 扩展 到 列表 :任何 string 类 型 的 列表 束 一 定 
是 object 类 型 的 列表 吗 ? 现实 是 残酷 的 : 


IList<string> strings 
IList<object> objects 


IEnumerable<T> 和 IList<T> 究 竟 有 何 区 别 ? 为 什么 换 成 list 就 不 行 ? 答案 
是 ， 换 成 list 之 后 就 不 再 安全 了 。 这 是 因为 在 TIList<T> 的 方法 中 ， 类 型 T 
既 用 作 输 入 ， 也 用 作 输 出 ; 而 在 IEnumerable<T> 中 ， 上 所 有 T 类 型 的 值 都 只 
用 作 输 出 。IList<T> 有 Add 这 样 的 方法 ， 接 收 T 型 值 作为 输入 。 这 个 类 型 
的 变 体 具有 潜在 的 危险 。 稍 微 扩 展 一 下 前 面 的 例子 : 


IList<string> strings = new List<string> { "a", "b", "c" }; 
IList<object> objects = strings; 

objects.Add(new object()); <------ 癌 列 表 添 加 一 个 新 的 对 象 
string element = strings[3]; <------ 以 string 类 型 取出 元 素 


妹 第 2 行 外 ， 其 他 代码 单独 看 都 没有 问题 。 把 一 个 object 类 型 的 引用 添 
加 到 IList<object> 列 表 中 没有 问题 ， 从 IList<string> 类 型 的 列表 中 读 


new List<string> { "a", "b", "c" }; 
strings; 











new List<string> { "a", "b", "c" }; 
strings; <------ 非法 : 不 存在 从 IList<string: 














取 一 个 string 的 元 素 中 也 没有 问题 。 可 是 如 果 人 允许 把 string 类 型 的 列表 
看 作 object 类 型 的 列表 ， 上 面 两 个 行为 就 会 发 生 冲 突 。 因 此 C# 从 语言 规 
则 上 禁止 第 2 行 代 码 ， 以 保证 另外 两 个 操作 是 安全 的 。 


前 面 讲 了 值 如 何 只 用 作 输 出 (IEnumerable<T>) ， 以 及 值 如 何 同 时 用 于 
输入 和 输出 (IList<T>) ， 而 有 些 API 中 值 总 是 用 作 输 入 ， 其 中 一 个 简 
单 的 例子 是 Action<T> 委 托 : 在 调用 委托 时 ， 为 其 传 入 一 个 类 型 为 ?的 值 
作为 输入 。 变 体 在 Action<T> 中 依然 起 作用 ， 不 过 方向 相反 。 这 一 差别 
在 刚 接触 时 比较 容易 让 人 困惑 。 


现在 假设 有 一 个 可 以 接收 object 类 型 的 Action<object> 委 托 ， 那么 该 委 
托 一 定 可 以 接收 一 个 string 类 型 的 引用 。 根 据 语言 规则 ， 可 以 有 从 


Action<object> 到 Action<string> 的 类 型 转换 : 








Action<object> objectAction 
Action<string> stringAction 
stringAction("Print me"); 


基于 以 上 示例 代码 ， 定 义 如 下 术语 。 


。 协 变 : 当 泛 型 值 只 用 作 输 出 时 。 
。 逆 变 : 当 泛 型 值 只 用 作 输 入 时 。 
。 不 变 : 当 泛 型 值 既 用 作 输 入 也 用 作 输 出 时 。 


目前 来 看 这 些 定义 还 不 够 清晰 ， 因 为 它们 只 是 一 些 比 较 宏 观 的 概念， 还 
没有 对 应 具体 内 容 。 在 了 解 了 C# 如 何 应 用 相关 变 体 语法 之 后 ， 就 能 将 这 


些 概念 融会 贯通 了 。 
4.4.2 ”接口 和 委托 声明 中 的 变 体 语法 


C# 变 体 的 第 一 要 点 : 变 体 只 能 用 于 接口 和 委托 ， 例 如 类 或 结构 体 的 协 变 
是 不 存在 的 。 第 二 : 变 体 的 定义 与 每 一 个 具体 的 类 型 形 参 绑 定 。 可 以 概 
括 地 说 “IEnumerable<T> 是 协 变 的 "， 而 更 准确 的 说 法 是 “IEnumerable<T> 
对 于 类 型 T 是 协 变 的 ”。C# 为 此 还 推出 了 新 语法 : 在 声明 接口 和 委托 的 语 
法 中 ， 可 以 为 每 个 类 型 形 参 添加 独立 修饰 件 。IEnumerable<T> 和 
IList<T> 接 口 以 及 Action<T> 委 托 的 声明 方式 如 下 : 


public interface IEnumerable<out T> 
public delegate void Action<in T> 


obj => Console.writeLine(obj); 
objectAction 











public interface IList<T> 
如 上 所 示 ， 修 饰 符 in 和 out 用 于 表示 类 型 形 参 的 变 体 属性 。 


。 用 out 修 饰 的 类 型 形 参 是 协 变 的 。 
。 用 in 修 饰 的 类 型 形 参 是 逆 变 的 。 
。 没有 修饰 符 的 类 型 形 参 是 不 变 的 。 


编译 器 会 根据 声明 所 在 上 下 文 的 其 他 内 容 来 检查 该 修饰 符 是 否 使 用 得 
当 。 例 如 下 和 面 这 个 委托 的 声明 就 是 非法 的 ， 因 为 类 型 形 参 用 作 输 入 ， 却 
被 声明 为 协 变 : 


public delegate void InvalidCovariant<out T>(T input ) 


SC ee 


public interface IInvalidContravariant<in T> 


T GetValue( ); 


任何 类 型 形 参 都 只 能 由 一 个 修饰 符 修饰 。 如 果 同 一 个 声明 中 有 多 个 类 型 
形 参 ， 那 么 该 声明 可 以 有 多 个 修饰 符 。 例 如 Func<T，TResult> 委 托 ， 它 
接收 一 个 类 型 为 T 的 输入 ， 返 回 一 个 类 型 为 TResult 的 输出 结果 。 很 自然 
地 ，T 应 该 是 逆 变 的 ，TResult 是 协 变 的 。 


public TResult Func<in T, out TResult>(T arg) 


在 日 常 开发 中 ， 一 般 直 接 使 用 这 些 已 经 声明 好 变 体 类 型 的 接口 和 委托 。 
对 于 可 使 用 的 类 型 实 参 ， 还 有 如 下 限制 。 


4.4.3 变 体 的 使 用 限制 

首先 重申 一 下 前 文 的 一 个 要 点 : 变 体 声明 于 接口 和 委托 中 ， 并 且 不 能 被 
实现 接口 的 类 或 结构 体 所 继承 。 类 和 结构 体 水 远古 不 可 变 的 。 假 设 有 如 
下 类 定义 : 


public class SimpleEnumerable<T> : IEnumerable<T> <------ 这 里 不 可 | 
{ 








不 能 根据 变 体 特性 把 simpleEnumerable<string> 转 换 
成 simpleEnumerable<object>， 但 是 可 以 利用 IEnumerable<T> 的 协 变 特 
性 ， 把 simpleEnumerable<string> 转 换 成 TEnumerable<object>。 


假设 我 们 正在 处 理 某 些 委托 或 接口 ， 这 些 委托 或 接口 具有 协 变 或 逆 变 的 
类 型 形 参 ， 那 么 哪些 类 型 转换 是 可 行 的 呢 ? 解释 规则 前 移 定 义 几 个 术 


语 。 





包含 变 体 的 转换 称 为 变 体 转换 。 

变 体 转换 属于 引用 转换 。 引 用 转换 不 改变 变量 的 值 ， 它 只 改变 变量 
在 编译 时 的 类 型 。 

一 致 性 转换 指 的 是 从 一 个 类 型 转换 为 一 个 相同 的 〈 从 CLR 的 角度 
看 ) 类 型 。 它 可 以 是 在 C# 中 同类 型 之 间 的 转换 (例如 string 类 型 
到 string 类 型 的 转换 ) ， 也 可 以 是 C# 中 不 同类 型 则 的 转换 ， 例 如 从 
object 到 dynamic 的 转换 。 


假设 有 类 型 实 参 A 和 B， 我 们 希望 将 IEnumerable<A> 转 换 
成 IEnumerable<B>。 只 有 存在 从 A 到 B 的 一 致 性 转换 或 隐 式 引用 转换 时 ， 
才能 完成 目标 转换 。 以 下 转换 均 合法 。 


e IEnumerable<string> 到 IEnumerable<object>， 因为 子 类 到 基 类 
(或 者 基 类 的 基 类 ， 以 此 类 推 ) 都 属于 隐 式 引用 转换 。 
。 IEnumerable<string> 到 IEnumerable<IConvertible>， 因 为 实现 类 到 
其 接口 的 转换 属于 隐 式 引用 转换 。 
e IEnumerable<IDisposable> 到 IEnumerable<object>， 任 何 引 用 类 型 


到 object 或 者 dynamic 类 型 都 属于 隐 式 引用 转换 。 
以 下 转换 此 非法 。 


e IEnumerable<object> 到 IEnumerable<string>， 因为 object 到 string 
属于 显 式 引用 转换 ， 而 非 隐 式 。 
e@ IEnumerable<string> 到 IEnumerable<Stream>: string 类 和 stream 类 


属于 非 相 关 类 。 


© IEnumerable<int> 到 IEnumerable<IConvertib1le>: int 


到 Iconvertible 存 在 隐 式 类 型 转换 ; 但 是 它 属 于 装 箱 转 换 ， 而 不 是 











引用 转换 。 
e@ IEnumerable<int> 人 到 IEnumerable<long>: int 到 long 存 在 隐 式 类 型 转 


换 ， 但 属于 数值 转换 而 非 引用 转换 。 


如 上 所 示 ， 类 型 实 参 的 转换 必须 是 引用 转换 或 一 致 性 转换 的 要 求 ， 出 人 
意料 地 影响 了 值 类 型 。 


IEnumerable<T> 的 例子 中 只 有 一 个 类 型 实 参 ， 如 果 有 多 个 类 型 实 参 呢 ? 
当然 是 要 逐一 检查 每 个 类 型 实 参 ， 确 保 每 个 实 参 转换 对 都 满足 上 述 要 
求 。 


更 正式 的 表述 为 : 假设 有 某 个 具有 n 个 类 型 形 参 的 泛 型 声明 : T<xi，... 
xi>， 完 成 T<Ali，...，Anh> 到 T<B;，...，Bn> 的 转换 ， 要 通过 通 历 从 1 到 nm 
之 间 的 每 个 i 值 来 检查 每 对 实 参 。 


。 如 果 xi 是 协 变 ，Ai 到 Bi 必须 存在 一 致 性 转换 或 者 隐 式 引用 转换 
。 如 果 Xxj 是 逆 变 ，Bi 到 Ai 必须 存在 一 致 性 转换 或 者 隐 式 引用 转换 。 
。 如 果 xj 是 不 可 变 的 ，Aij 到 Bi 必须 存在 一 致 性 转换 。 


以 Func<in T，out TResult> 为 例 解释 上 述 规则 。 


e@ Func<object, int> 到 Func<string， int> 存 在 合法 的 转换 ， 因 为 : 
o 第 1 个 类 型 形 参 是 逆 变 的 ，string 到 object 存 在 隐 式 引用 转 


换 ; 
o 第 2 个 类 型 形 参 是 协 变 的 ，int 到 int 存 在 一 致 性 转换 。 
e Func<dynamic, string> 到 Func<object， IConvertible> 存 在 合法 转 
换 ， 因为 : 
o 第 1 个 类 型 形 参 是 逆 变 的 ，dynamic 到 object 存 在 一 任性 转换 ; 
o 第 2 个 类 型 形 参 是 协 变 的 ，string 到 Iconvertible 存 在 隐 式 引用 
转换 。 
e Func<string, int> 到 Func<object， int> 不 存在 合法 转换 ， 因为 : 
o | object 到 string 不 存在 隐 式 引用 转 


。 当 第 1 个 类 型 形 参 转变 非法 时 ， 整 个 转换 就 是 非法 的 ， 第 2 个 类 
型 形 参 是 否 合法 就 无 须 考量 了 。 


面 对 这 样 一 堆 复 杂 的 规则 ， 是 不 是 有 点 应 接 不 暇 呢 ? 其 实 无 须 担 忧 ， 

















99% 的 情况 下 我 们 根本 不 会 意识 到 正在 使 用 泛 型 型 变 。 我 列 出 这 些 规 
则 ， 是 为 了 方便 困 于 某 个 编译 错误 的 读者 查找 错误 原因 3。 下 面 介绍 泛 
型 型 变 的 具体 应 用 场景 。 


3 对 于 东 些 特殊 的 报错 ， 前 面 列 举 的 内 容 可 能 还 不 足以 定位 问题 ， 建 议 
阅读 本 书 第 3 版 ， 相 关 描 述 更 详细 。 


4.4.4 泛 型 型 变 实 例 


很 多 情况 下 ， 我 们 并 没有 察觉 应 用 了 泛 型 型 变 的 特性 ， 因 为 它 总 是 与 我 
们 的 上 自然 预期 相 一 致 。 尽 管 如 此 ， 还 是 有 必要 列举 泛 型 型 变 的 几 个 应 用 


为 了 水 。 


首先 是 LINQ 和 IEnumerable<T>。 假 设 有 一 个 字符 串 集 合 ， 我 们 希望 对 集 
合 执行 查询 操作 ， 并 希望 最 后 得 到 的 i 果 是 List<object> 类 型 而 不 

是 List<string> 类 型 。 之 后 还 有 可 能 回访 list 添 加 新 元 素 。 在 协 变 特性 出 
现 之 前 ， 最 简单 的 实现 方式 就 是 调用 cast 方 法 ， 


代码 清单 4-20 ”通过 字符 串 查 询 获 得 List<object>， 不 使 用 泛 型 型 
变 


IEnumerable<string> strings = new[] { "a", "b", "cdefg", "hij" }; 
List<object> list = strings 

.Where(x => x.Length > 1) 

.Cast<object>() 

.ToList(); 


我 不 太 习 惯 这 种 方式 。 在 管道 (pipeline〉 中 额外 添加 一 步 类 型 转换 的 
0 
ye 


代码 清单 4-21 通过 字符 串 查 询 获 得 List<object>， 使 用 泛 型 型 变 


IEnumerable<string> strings = new[] { "a", "b", "cdefg", "hij" }; 
List<object> list = strings 

.Where(x => x.Length > 1) 

.ToList<object>(); 

















Where 调用 的 经 吉 果 是 IEnumerable<string> 类 型 的 ， ToList<object>() 相 当 
于 让 编译 器 把 该 结果 看 作 IEnumerable<object> 类 型 。 由 于 泛 型 型 变 的 存 


在 ， 该 操作 是 可 行 的 。 


此 外 ，Icomparer<T> 与 逆 变 联 用 会 有 奇效 。Icomparer<T> 接 口 用 于 在 排 

序 过 程 中 与 其 他 类 型 值 比较 大 小 。 假 设 有 一 个 基 类 shape， 它 有 一 

个 Area 的 属性 ， 并 且 有 circle 和 Rectangle 两 个 子 类 继承 自 Shape。 我 们 

可 以 编写 一 个 实现 Icomparer<shape> 接 口 的 Areacomparer 方 法 ， 通 过 调 

用 List<T>.Sort() 方 法 对 List<shape> 进 行 排序 。 但 如 果 是 List<circle> 
或 者 List<Rectangle>， 该 如 何 排序 呢 ? 虽然 在 泛 型 型 变 出 现 之 前 已 有 不 
少 解决 办 法 ， 但 有 了 变 体 之 后 ， 这 项 工作 轻松 了 很 多 。 


代码 清单 4-22 ”通过 Icomparer<Shape> 对 List<Ccircle> 排 序 


List<Circle> circles = new List<Circle> 


{ 
new Circle(5.3), 
new Circle(2), 
new Circle(10.5) 
}; 


circles.Sort(new AreaComparer()); 
foreach (Circle circle in circles) 


Console.writeLine(circle.Radius); 


代码 清单 4-22 的 完整 源码 可 以 从 线 上 下 载 ， 而 且 完 整 源码 也 十 分 简洁 。 
关键 之 处 在 于 调用 sort 方 法 时 将 Areacomparer 转 换 成 Icomparer<circle> 
类 型 。 在 C# 4 出 现 以 前 是 无 法 实现 的 。 


在 声明 自己 的 接口 或 者 委托 时 ， 考 虑 一 下 其 类 型 形 参 是 合 文 持 协 变 或 者 
逆 变 是 很 有 必要 的 。 如 果 一 个 接口 可 以 支持 变 体 ， 其 作者 却 并 没有 考虑 
到 这 一 点 ， 会 让 人 很 恼火 。 





4.5 小结 


。 C# 4 文 持 动态 类 型 ， 动 态 类 型 的 绑 定 操作 从 编译 时 推迟 到 执行 期 执 
行 。 

@ 通过 IDynamicMetaobjectProvider 和 Dynamicobject 类 ， 动态 类 型 可 
以 支持 自 定义 行为 。 

。 动态 类 型 由 编译 器 和 framework 提 供 的 特性 共同 实现 。framework 通 
过 优化 和 重度 缓存 提升 了 动态 类 型 的 性 能 。 


C# 4 允许 形 参 指定 默认 值 。 指 定 了 默认 值 的 形 参 称 为 可 选 形 参 ， 方 
法 调用 方 可 以 省 略 相 应 的 实 参 。 

C# 4 允许 为 实 参 提供 对 应 的 形 参 名 称 。 该 特性 与 可 选 形 参 搭配 使 
用 ， 可 以 让 我 们 在 提供 实 参 时 进行 取舍 。 

C# 4 允许 COM 主 互 操 作 程序 集 以 链接 方式 使 用 而 不 是 以 引用 方 

式 。 链 接 方 式 可 以 让 部 署 工作 更 灵活 简单 。 

链接 的 PIA 以 动态 类 型 对 外 提供 变量 值 ， 可 以 避免 不必 要 的 类 型 转 


换 。 
可 选 形 参 特 性 针对 COM 库 进行 了 扩展 ， 使 得 ref 形 参 也 具有 可 选 属 
性 








外 
。 COM 库 中 的 ref 形 参 可 以 以 值 的 方式 指定 。 


泛 型 型 变 特性 可 以 让 泛 型 接口 和 泛 型 委托 安全 地 进行 类 型 转换 ， 无 
论 泛 型 值 用 作 输 入 还 是 输出 。 


第 5 章 编号 姑 步 代 但 
本 章 内 容 概览 


。 何谓 编写 异步 代码 ; 

。 如 何 通 过 async 修 饰 符 声明 异步 方法 ; 

。 如 何 通过 await 操 作 进 行 异步 等 待 ; 

。 C# 5 带 来 的 async/await 在 语言 层面 的 变化 ; 
。 异步 代码 遵循 何 种 使 用 规范 。 


异步 问题 一 直 是 开发 痛 点 。 众 所 周知 ， 异 步 编程 可 以 解决 线程 因为 等 待 
Ge 但 如 何 正 确实 现 异 步 模 式 一 直 是 一 头 已 
J 迫 路 虎 。 


即便 是 .NET Framework 这 样 相 对 年 轻 的 框架 ， 也 提供 了 3 种 异步 编程 的 
模型 ， 旨 在 减少 开发 人 员 的 “痛楚 ”。 


e。 .NET 1.x 时 代 的 BeginFoo/EndFoo 模 型 ， 该 模型 使 用 IAsyncResulLlt 和 
Asynccallback 来 填充 结果 。 

。 .NET 2.0 时 代 的 事件 驱动 异步 模型 ， 该 模型 通过 Backgroundworker 
和 webclient 实 现 。 

。 .NET 4.0 时 代 的 任务 并 行 库 (TPL) 方案 ，.NET 4.5 又 将 其 扩展 。 


不 可 人 否认， 任务 并 行 库 方案 在 总 体 设计 上 十 分 优秀 ， 但 想 通 过 它 来 编写 

稳健 、 易 读 的 异步 代码 依然 很 困难 。 尽 管 任务 并 行 库 对 并 行 的 支持 相当 

是 但 异步 的 某 些 通用 属性 最 好 能 从 语言 层面 修正 ， 而 不 是 单纯 靠 类 
来 实现 。 


C# 5 推出 的 最 重要 的 特性 通常 称 为 async/await 。 该 特性 基于 任务 并 行 

库 ， 它 赋予 了 开发 人 员 以 形 如 同步 编程 的 方式 来 编写 异步 代 码 。 从 此 告 
别 了 那些 烦琐 的 回调 、 事 件 订 阅 以 及 碎 卢 化 的 错误 处 理 。 从 此 腊 步 代 码 
也 可 以 清晰 地 表达 意图 ， 也 能 以 开 及 人 员 熟 悉 的 结构 来 构建 。C# 5 引入 
的 新 语言 架构 使 开发 人 员 可 以 await 某 个 异步 操作 完成 。await 的 语法 看 
起 来 与 普通 的 阻 窄 调用 十 分 相像 一 一 在 当前 操作 完成 前 ， 后 续 的 代码 将 
暂 不 执行 ， 但 await 并 不 会 阻 窒 当前 线程 。 虽 然 听 起 来 磊 有 些 自 相 矛盾 ， 














但 相信 经 过 本 章 的 讲解 ， 读 者 能 够 齿 然 开明 。 


async/await 特 性 目 C# 5 推出 之 后 经 历 了 一 些小 的 更 新 迭代 ， 方 便 起 见 ， 
本 章 也 睹 括 了 C# 6 和 C# 7 中 关于 该 特性 的 改进 部 分 。 当 涉及 这 些 方面 的 
内 容 时 会 明确 指出 ， 因 为 这 些 特性 需要 C# 6 或 者 C# 7 的 编译 器 文 持 。 


.NET Framework 4.5 全 面 接纳 了 异步 。framework 中 提供 的 很 多 操作 是 基 
于 任务 的 异步 模式 ， 对 外 提供 了 路 API 的 一 致 性 体验 。 与 之 类 似 ， 
Windows Runtime 平 台 〈 通 用 Windows 应 用 程序 UWA/UWP 的 基础 ) 也 
强制 所 有 长 耗 时 或 潜在 长 耗 时 ) 的 操作 异步 化 。 许 多 现代 API〈 比 如 
Roslyn 和 Httpclient ) 重度 依赖 异步 模式 。 总 而 言 之 ， 大 部 分 C# 程 序 员 
在 工作 中 或 多 或 少 会 用 到 异步 特性 。 


说 明 Windows Runtime 平 台 就 是 通常 所 讲 的 WinRT。 不 要 把 这 个 
概念 与 Windows RT 搞 泥 了 ，Windows RT 是 Windows 8.x 为 ARM 处 
理 器 提供 的 操作 系统 版 本 。 通 用 Windows 应 用 程序 CUWP) 是 
Windows Store 应 用 程序 的 改进 版 。UWP 是 UWA 在 Windows 10 操 作 
系统 上 的 改进 版 。 


需要 澄清 一 点 ，C# 在 执行 并 行 或 异步 操作 时 并 非 无 所 不 能 。 虽 然 编 译 器 
日 益 智 能 化 ， 但 还 是 无 法 消除 异步 执行 天 然 的 复杂 性 。 对 于 异步 编程 ， 
编程 人 员 依 然 需 要 认真 思考 。 而 async/await 模 式 的 美妙 之 处 就 在 于 ， 它 
es 繁复 难 懂 的 样板 代码 ， 这 样 开发 人 员 就 可 以 集中 精力 攻 
| 难 了 。 


温 世 提示 : 弄 步 话题 属于 C# 中 的 高 阶 话题 ， 它 对 于 开 及 人 员 来 说 非常 重 
要 《即便 是 初级 开发 ， 也 需要 对 该 领域 有 所 领会 ) ， 但 是 起 始 阶段 的 学 
习 叉 俩 于 艰深 。 


本 章 内 容 主要 针对 一 般 的 异步 开发 ， 这 样 大 家 无 须 深 入 了 解 技 术 细 市 ， 
便 能 使 用 async/await 特 性 。 第 6 音 会 探讨 更 为 复杂 的 异步 编程 的 实现 原 
理 。 深 入 了 解 技术 原理 当然 有 助 于 提升 开发 能 力 ， 但 学 习 本 章 内 容 也 能 
有 效 提 升 async/await 的 开发 效率 。 本 章 内 容 虽 然 相 对 基础 ， 但 依然 需要 
循序 渐进 地 消化 和 理解 每 个 新 特性 。 


5.1 异步 函数 简介 























前 面 只 是 粗略 地 提 到 C# 5 简化 了 异步 编 程 ， 并 没有 详细 探讨 其 中 各 个 特 
性 ， 下 面 从 一 个 示例 看 起 。 


C# 5 引入 了 异步 函 数 的 概念 。 卉 步 函 数 可 以 指 某 个 由 async 修 饰 符 修 饰 
的 方法 或 者 匿名 函数 ， 它 可 以 对 await 表 达 式 使 用 await 运 算 符 。 


说 明 ”匿名 函数 指 lambda 表 达 式 或 者 匿名 方法 。 


研究 C# 语 言 异步 编程 的 变化 ，await 表 达 式 是 最 佳 切 入 点 : 如 果 await 表 
达 式 所 做 的 操作 尚未 完成 ， 异 步 函 数 将 立即 返回 ， 当 表达 式 的 值 可 用 之 
后 ， 代 码 将 从 之 前 的 位 置 (在 恰当 的 线程 中 )〉 恢复 执行 。 当 前 语句 执行 
完成 前 ， 下 一 条 语句 不 会 执行 ， 这 条 目 然 流程 依然 适用 ， 只 是 当前 线程 
不 阻 蹇 。 以 上 描述 可 能 不 够 清晰 ， 下 面 用 更 具体 的 术语 和 行为 来 讲解 ， 
不 过 在 这 之 前 先 看 一 个 例子 。 








5.1.1 异步 问题 初 体验 


从 一 个 简单 、 具 有 实际 意义 的 异步 场景 开始 。 在 实际 应 用 中 ， 网 络 延迟 
问题 颇 为 烦 扰 ， 然 而 网 络 延 迟 非常 适 于 展示 异步 模式 的 重要 性 ， 尤 其 在 
使 用 如 Windows Forms 这 类 GUI 框 架 时 。 接 下 来 的 第 一 个 例子 就 是 一 个 
小 型 Windows Forms 应 用 ， 它 从 本 书 网 站 的 主页 获取 文字 内 容 ， 然 后 通 
过 HTML 中 的 标签 显示 页 面 长 度 。 


代码 清单 5-1 采用 async 方 法 显示 页 面 长 度 


public class AsyncIntro : Form 




















private static readonly HttpClient client = new HttpClient(); 
private readonly Label label; 
private readonly Button button; 


public AsyncIntro() 
label = new Label 


Location = new Point(10, 20), 
Text = "Length" 

}; 

button = new Button 


Location = new Point(10, 50), 


Text = "Click" 
}; 
button.click += DisplaywebSiteLength; <------ 关联 事件 处 理 器 
AutoSize = true 
Controls.Add(1label); 
Controls.Add(button); 


























S 


async void DisplaywebSiteLength(object sender, EventArgs e) 


label.Text = "Fetching..."; 
string text = await client.GetStringAsync( (本 行 及 以 下 1 行 ) 
"http://csharpindepth.com"); 


label.Text = text.Length.ToString(); <------ 更 新 UI 
} 
static void Main() 
{ 
Application.Run(new AsyncIntro()); <------ 程序 入 口 : 开始 运 和 


以 上 代码 的 第 一 部 分 内 容 创 建 了 UI， 并 将 按钮 与 某 个 事件 处 理 器 相关 
联 。 这 里 需要 关注 DisplaywebsiteLength 方 法 。 当 发 生 按 钮 点 击 事件 
时 ， 0 然后 更 新 标签 内 容 来 显示 页 
面 长 度 。 


说 明 ”虽然 Task 实 现 了 IDisposable 的 接口 ， 但 代码 中 并 没有 执行 
On 好 在 一 般 不 需要 回收 任 











虽然 这 里 可 以 采用 一 个 更 简短 的 console 应 用 作为 示例 ， 但 代码 清单 5-1 

更 具 说 服 力 。 需 要 特别 指出 的 是 ， 如 果 去 挥 代码 中 的 async 和 await 关 键 
字 ， 把 Httpclient 蔡 换 成 Webclient， 把 GetSstringAsync 蔡 换 

为 Downloadstring， 以 上 代码 依然 可 以 正常 编译 和 运行 ， 只 不 过 在 获取 
页 面 内 容 时 ， 程 序 的 UI 在 会 暂停 啊 应 。 而 如 果 运 行 异步 版 本 的 代码 (最 
好 是 在 一 个 网 络 延 时 比较 高 的 环境 中 ) ， 就 会 看 到 程序 UI 是 可 以 啊 应 用 
户 操作 的 : 比如 在 获取 页 面 的 同时 移动 应 用 程序 窗口 。 


说 明 ”可 以 把 Httpclient 看 作 webclient 的 改进 版 。 它 优先 选 
择 .NET 4.5 之 后 的 HITP API， 这 套 API 只 包含 异步 模式 的 操作 。 











0 0 0 
\ 阳 生 : 


。 不 要 在 UI 线程 中 执行 任何 长 耗 时 的 操作 ; 
。 不 要 在 UI 线程 以 外 访问 UI 的 控件 。 


虽然 Windows Forms 如 今 可 能 已 经 属于 过 时 的 技术 了 ， 但 大 部 分 GUI 的 
框架 还 遵循 者 上 述 两 条 法 则 ， 虽 然 这 样 的 法 则 实践 起 来 并 不 那么 容易 。 
作为 练习 ， 读 者 可 以 尝试 在 不 使 用 async/await 的 情况 下 ， 实 现 类 似 于 代 
码 清单 5-1 功 能 的 代码 。 对 于 这 个 简单 的 例子 ， 可 以 使 用 基于 事件 的 
webCclient.DownloadSstringAsync 方 法 ， 但 是 随 着 控制 流 的 不 断 复杂 化 
《错误 处 理 、 等 待 多 个 页 面 操作 完成 等 ) ， 遗 留 代 码 就 会 变 得 愈 发 难以 
维护 ;而 如 果 使 用 C# 5 来 实现 ， 之 后 的 代码 修改 都 可 以 顺 乎 自然 了 。 
现在 DisplaywebsiteLength 方 法 看 上 去 很 神奇 ， 它 能 按照 预期 的 方式 执 


行 ， 但 我 们 不 知道 它 是 如 何 做 到 的 。 具 体 细节 和 暂且 不 表 ， 它 会 是 后 面 内 
容 的 重头 戏 。 


5.1.2 拆 分 第 一 个 例子 
接 下 来 稍微 扩展 上 述 方法 。 代 码 清单 5-1 中 对 


Httpclient .GetStringAsync 返 回 值 直接 使 用 了 await 关 键 字 。 实 际 上 ， 
还 可 以 把 await 和 方法 调用 拆 分 开 : 


async void DisplaywebSiteLength(object sender, EventArgs e) 














label.Text = "Fetching..."; 
Task<string> task = client.GetStringAsync("http://csharpindep 
string text = await task; 
label.Text = text.Length.ToString(); 
} 


请 注意 ， task 变 量 的 类 型 是 Task<string>， 但 是 await task 表 达 式 的 类 
型 只 是 string。 就 本 例 来 说 ，await 运 算 符 执 行 了 一 次 拆 封 操作 ， 至 少 
当 await 的 对 象 是 Task<TResult> 类 型 时 如 此 。 (之 后 会 讲 到 ，await 的 目 
标 值 也 可 以 是 其 他 类 型 ， 不 过 Task<TResult> 类 型 适合 作为 入 门 。) 这 
也 是 await 特 性 的 一 个 方面 ， 虽 然 不 与 异步 问题 直接 相关 ， 但 它 能 够 简 
化 编码 工作 。 








await 的 主要 作用 是 避免 在 等 待 长 耗 时 操作 时 线程 被 阻 蹇 。 读 者 可 能 想 
知道 ， 就 线程 而 言 这 是 如 何 实现 的 呢 ? 因为 在 方法 的 开始 和 末尾 都 对 
label.Text 赋 值 y ， 所 以 有 理由 认为 这 些 语句 就 是 在 UI 线 程 中 执行 的 ， 
但 显然 在 加 载 页 面 的 过 程 中 ，UI 线 程 并 没有 被 阻塞。 


其 中 的 关键 在 于 : 执行 到 await 表 达 式 时 ， 方 法 立即 返回 。 在 执行 

到 await 之 前 ，UI 线 程 代 码 都 是 以 同步 方式 执行 的 ， 正 如 其 他 事件 处 理 
嚣 一样。 如果 调试 代码 ， 在 第 一 行 添加 一 个 断 点 ， 束 会 看 到 stack 
track 显 示 按 钮 正 处 于 触发 click 事 件 中 ， Button.0nclick 方 法 也 是 一 
样 。 当 执行 到 await 时 ， 代 码 会 检查 是 否 已 得 到 执行 结果 ， 如 果 还 没有 
(在 本 例 中 几乎 是 肯定 的 ) ， 它 束 会 创建 一 个 续 延 (continuation) ， 当 
Web 操 作 完 成 后 ， 束 执行 该 续 廷 。 在 本 例 中 ， 续 延 会 执行 方法 的 其 余 内 
容 ， 直 接 跳 转 到 await 表 达 式 的 末尾 。 续 延 的 执行 还 是 在 UI 线程 中 ， 
为 后 面 还 需要 控制 UI 控件 。 


定义 ” 续 延 本 质 上 是 回调 函数 ， 当 异步 操作 《任务 ) 执行 完成 后 被 
调 起 。 在 async 方 法 中 ， 续 延 负 贡 维 护 方法 的 状态 。 类 似 于 闭 包 维 
护 变量 的 上 下 文 ， 续 延 会 记录 方法 的 执行 位 置 ， 以 便 之 后 恢复 方法 
的 执行 。Task 类 有 一 个 专门 用 于 附加 续 延 的 方 


法 : Task.Continuewith。 


如 果 在 await 表 达 式 之 后 的 某 个 位 置 添加 一 个 断 点 并 再 次 运行 代码 ， 由 

于 await 表 达 式 需要 安排 续 延 ， 因 此 就 会 看 到 栈 追 踪 中 不 再 

有 Button.onclick 方 法 ， 因 为 该 方法 早已 执行 完成 了 。 现 在 调用 栈 中 应 
该 只 有 Windows Forms 的 事件 循环 ， 再 往 上 则 是 一 些 异 步 基础 架构 层 。 

这 样 的 调用 栈 状 态 ， 与 从 后 台 线 程 调用 control.Invoke 来 更 新 UI 的 调用 
栈 状 态 相 似 ， 只 不 过 这 些 都 已 经 蔡 我 们 自动 完成 了 。 刚 开始 查看 调用 栈 
6 
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上 述 过 程 是 由 编译 器 创建 的 一 个 复杂 的 状态 机 完成 的 。 第 6 章 会 探讨 该 


状态 机 的 实现 细 市 ， 现 在 重 所 介绍 async/await 所 提供 的 功能 。 首 先 探讨 
对 于 异步 编程 ， 开 发 人 员 想 要 的 功能 和 语言 实际 所 能 提供 的 功能 。 


5.2 ”对 有 异步 模式 的 岂 
如 果 让 一 个 开发 人 员 描 述 什 么 是 异步 执行 ， 回 答 多 半 会 以 多 线程 开头 。 





























里 然 多 线程 是 异步 模式 的 一 项 典型 用 途 ， 但 不 是 异步 执行 的 必要 条 件 。 
为 了 充分 理解 C#5 中 异步 特性 的 工作 机 制 ， 首 先 需 要 摆脱 线程 的 忠 维 束 
缚 ， 回 归 这 个 问题 的 本 质 。 


5.2.1 关于 异步 执行 本 质 的 思考 


异步 模式 可 谓 直击 C# 程 序 员 所 熟悉 的 执行 模型 的 核心 。 考 虑 如 下 简单 代 
码 ; 


Console.writeLine("First"); 
Console.writeLine("Second"); 


对 于 以 上 代码 ， 我 们 认为 第 2 行 代 人 码 应 该 在 第 1 行 执行 完成 之 后 开始 。 执 
行 流 是 沿 着 语句 的 顺序 依次 向 后 的 ， 但 是 异步 模式 并 不 遵循 上 述 规 则 。 
异步 模式 围绕 续 延 这 一 概念 : 指示 某 项 操作 执行 完成 之 后 执行 什么 操 

作 。 读 者 可 能 会 联想 到 回调 ， 不 过 回调 的 含义 比 续 延 模式 更 广泛 。 就 异 
步 而 言 ， 续 延 用 于 代 指 可 以 保存 程序 执行 状态 的 回调 ， 而 不 是 类 似 于 

GUI 事件 处 理 器 这 类 专用 回调 。 


在 .NET 中 ， 续 延 的 本 质 是 类 型 为 action 的 委托 ， 它 们 负责 接收 异步 操作 
的 结果 。 因 此 ， 在 C# 5 之 前 调用 webclient 的 异步 方法 时 ， 需 要 针对 成 
功 、 失 败 等 诸多 结果 编写 相应 的 事件 处 理 。 这 么 做 的 问题 在 于 ， 对 于 那 
些 步骤 特别 复杂 的 情况 ， 编 写 如 此 多 的 委托 方法 最 终 会 导致 问题 变 得 更 
加 复杂 。 即 便 借助 lambda 表 达 式 也 无 济 于 事 ， 而 想 确 保 错 误 处 理 的 逻辑 
无 误 更 是 困难 。《 以 这 种 方式 编写 的 异步 代码 ， 我 对 成 功 路 径 的 代码 比 
较 有 把 握 ， 对 于 失败 的 处 理 代码 则 没有 十 足 把 握 。) 


await 在 C# 中 的 任务 本 质 上 是 请 求 编 译 器 为 我 们 创建 续 延 。 尽 管 构想 简 
单 ， 却 能 显著 增强 代码 可 读 性 ， 让 开发 人 员 更 从 容 。 


前 面 对 于 异步 模式 的 描述 比较 理想 化 ， 实 际 上 基于 任务 的 异步 模式 要 上 略 
有 不 同 。 在 真实 的 异步 模型 中 ， 续 延 并 没有 传递 给 异步 操作 ， 而 是 由 异 
步 操 作 及 起 并 返回 了 一 个 令 牌 ， 该 令 牌 可 供 续 延 使 用 。 该 令 牌 代表 正在 
执行 的 操作 ， 该 操作 可 能 在 返回 到 调用 方 之 前 就 已 经 执行 完成 了 ， 也 可 
能 还 在 执行 中 。 该 令 牌 用 于 表达 : 在 该 操作 完成 前 不 能 开始 后 续 的 处 理 
令 脾 通常 是 以 Task 或 Task<TResult> 的 形式 出 现 的 ， 但 并 非 强 制 要 





























说 明 这 里 的 令 牌 与 取消 令 牌 不 同 。 二 者 的 共同 之 处 是 ， 都 强调 不 
必 关 心 背 后 正在 发 生 的 操作 ， 只 需要 知道 令 脾 所 允许 的 行为 即 可 。 


C# 5 的 异步 方法 典型 的 执行 流程 如 下 : 

(1) 执行 某 些 操作 ; 

(2) 启动 一 个 异步 操作 ， 并 记录 其 返回 的 令 牌 ; 
完 


(3) 执行 某 些 其 他 操作 (通常 在 异步 操作 完成 前 不 能 进行 后 续 操 作 ， 对 
应 这 一 步 应 该 为 空 ) ; 


(4) 〈 利 用 令 牌 ) 等 待 异步 操作 完成 ; 
(5) 执行 其 他 操作 ; 
(6) 完成 执行 。 


如 果 忽 略 等 竺 环节， 那么 以 上 工作 使 用 C# 4 便 能 完成 。 如 果 可 以 接受 在 
异步 操作 完成 前 线程 被 阻塞 ， 那 么 使 用 令 牌 通常 也 可 以 实现 ， 对 于 一 
个 Task， 仅 调用 wait() 方 法 即 可 ， 但 这 样 做 会 造成 线程 资源 浪费 ， 线程 
停止 工作 了 。 就 好 比 打 电 话 订 了 比萨 外 卖 ， 然 后 站 在 家 门口 一 直 等 比萨 
送 达 ， 而 在 现实 生活 中 ， 我 们 会 利用 等 比萨 送 达 的 这 段 时 间 去 做 其 他 事 
情 。 此 时 就 需要 await 出 场 了 。 


等 竺 异步 操作 其 实 是 在 表达 : 现在 代码 不 能 往 下 执行 了 ， 等 待 操作 完成 
后 再 继续 执行 。 那 么 如 何 才能 不 阻塞 线程 呢 ? 答案 很 简单 ， 那 就 是 立即 
返回 ， 之 后 继续 有 异步 地 执行 目 身 。 如 果 想 让 调用 方 知道 异步 方法 何 时 完 
成 ， 则 需要 传递 一 个 令 牌 给 调用 方 ， 这 样 调用 方 就 可 以 选择 阻 窟 于 该 令 
牌 上 ， 或 者 《更 有 可 能 ) 将 该 令 牌 用 于 太一 个 续 延 。 通 常 最 终 部会 得 到 
一 批 相互 调用 的 异步 方法 ， 感 觉 束 像 进 入 了 某 段 代码 的 一 种 “异步 模 

式 ”。 语 言 规范 中 并 没有 要 求 如 此 实现 ， 但 事实 上 对 于 调用 异步 操作 的 
0 





5.2.2 ”同步 上 下 文 
前 文 提 到 UI 代码 的 黄金 法 则 之 一 是 不 在 UI 线程 之 外 更 新 UI。 在 代码 清单 


5-1 中 ， 需 要 确保 await 表 达 式 之 后 的 代码 在 UI 线程 中 执行 。 异 步 函 数 使 
用 synchronizationcontext 类 确保 代码 能 够 返回 正确 的 线程 

中 ，synchronizationcontext 类 诞生 于 .NET 2.0， 用 于 像 
Backgroundworker 这 样 的 组 件 中 。 SynchronizationCcontext 类 负责 在 正 
确 的 线程 中 执行 委托 。 该 类 中 的 Post (异步 ) 和 send (同步 ) 消息 机 制 
类 似 于 Windows Forms 的 control.BeginInvoke 方 法 和 control.Invoke 方 
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不 同 的 执行 环境 会 使 用 不 同 的 上 下 文 ， 例 如 某 个 上 下 文 可 能 会 允许 线程 
闻 中 某 个 线程 执行 给 定 操 作 。 卉 步 模 式 的 上 下 文 信息 比 同步 上 下 文 要 
多 ， 想 要 搞 清 楚 异 步 方法 如 何 准确 地 在 需要 的 上 下 文中 执行 ， 首 先 需 要 
重点 关注 同步 上 下 文 。 


关于 Synchronizationcontext 的 更 多 内 容 ， 请 参阅 Stephen Cleary 在 
MSDN 上 发 表 的 文章 “Parallel Computing - It's All About the 
SynchronizationContext”。ASP.NET 开 发 人 员 需 要 格外 小 心 ， 如 果 对 
ASP.NET 的 上 下 文 不 够 仔细 ， 容 易 编 写 出 看 起 来 正确 但 实际 上 会 造成 死 
锁 的 代码 。 在 ASP.NET Core 推 出 之 后 情况 略 有 改善 。Stephen Cleary 在 
他 的 另外 一 篇 博文 〈“ASP.NET Core SynchronizationContext”) 中 探讨 了 
相关 话题 。 


示例 中 的 Task.wait() 和 Task.Result 


前 面 的 示例 代码 中 使 用 了 Task.wait() 和 Task.Result， 骨 在 让 例子 
尽 可 能 简单 。 通 稼 在 console 应 用 中 这 么 做 比较 安全 ， 因 为 console 应 
用 不 涉及 同步 上 下 文 。async 方 法 的 续 延 总 在 线程 池 中 执行 。 


在 实际 应 用 中 ， 使 用 这 两 个 方法 需要 格外 小 心 。 在 执行 完成 前 ， 它 
们 都 会 造成 线程 阻塞 ， 即 如 果 在 一 个 需要 执行 续 延 的 线程 中 执行 这 
两 个 方法 ， 就 会 导致 当前 应 用 发 生死 锁 。 


理论 部 分 的 探讨 暂且 为 上 上， 下 面 深入 探 完 异步 方法 的 具体 细节 。 卉 步 匿 
名 函数 采用 的 是 相同 的 设计 思路 ， 但 异步 方法 讨论 起 来 要 容易 得 多 。 
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5.2.3 ”异步 方法 模型 
可 以 如 图 5-1 所 示 看 待 异步 方法 。 


图 5-1 划分 异步 边界 


其 中 有 三 个 代码 块 《〈 方 法) 和 两 个 边界 类 型 〈 方 法 返回 类 型 ) 。 接 下 来 
把 前 面 获取 页 面 长 度 的 例子 改造 成 一 个 简单 的 console 应 用 。 


代码 清单 5-2 ”在 异步 方法 中 获取 页 面 长 度 


static readonly HttpClient client = new HttpClient(); 





static async Task<int> GetPageLengthAsync(string Url) 

{ 
Task<string> fetchTextTask = client.GetStringAsync(ur1); 
int length = (await fetchTextTask) .Length ; 
return length; 


. 


static void PrintPageLength'( ) 


Task<int> lengthTask = 
GetPageLengthAsync("http://csharpindepth.com"); 
Console.writeLine(lengthTask.Result); 


} 
图 5-2 是 代码 清单 5-1 映 射 到 图 5-1 后 的 结果 。 








图 5-2 ”代码 清单 5-1 映 射 到 图 5-1 的 通用 模式 


虽然 这 里 主要 关注 GetPageLengthAsync 方 法 ， 但 我 把 PrintPageLength 方 
法 也 列 出 来 了 ， 以 便 观察 方法 之 间 是 如 何 交 互 的 。 特 别 需 要 注意 ， 我 们 
需要 知道 方法 边界 处 的 有 效 类 型 。 之 后 图 5-2 会 以 各 种 形式 贯穿 于 本 章 
的 讲解 中 。 


下 面 介 绍 如 何 编写 async 方 法 以 及 async 方 法 的 行为 模式 。 这 部 分 内 容 信 
恩 量 很 大 ， 包 括 : 使 用 async 方 法 所 能 实现 的 功能 、 合 加 使 用 async 方 法 











的 效果 等 。 


对 于 异步 编程 ， 只 有 两 点 新 语法 : async 修 饰 符 和 await 运 算 符 。async 用 

于 修饰 异步 方法 的 声明 ，await 用 于 消费 异步 操作 。 不 过 ， 跟 随 着 程序 

代码 中 不 同 部 分 之 间 信 息 传 递 的 增加 ， 和 情况 很 快 束 会 变 得 十 分 复杂 ， 尤 

其 是 在 定位 程序 错误 时 。 书 中 尽量 分 别 讨论 各 个 部 分 ， 但 实际 代码 无 法 

如 果 读 者 对 某 部 分 内 容 有 疑问 ， 请 不 要 心急 ， 后 续 内 容 会 给 
孚 答 。 


接 下 来 分 3 节 探 讨 异 步 方法 ， 这 3 个 阶段 逐 层 递 进 。 
。 声明 async 方 法 。 
。 使 用 await 运 算 符 等 待 异 步 操 作 执 行 完成 。 
。 方法 执行 完成 后 返回 值 。 

图 5-3 展 示 了 3 节 内 容 在 理论 模型 中 的 位 置 。 

















图 5-3 5.3 节 、5.4 节 和 5.5 节 内 容 在 理论 模型 中 的 位 置 


从 最 简单 的 部 分 开始 : 声明 async 方 法 。 
5.3 async 方法 声明 
除了 新 增 了 async 关 键 字 ，async 方 法 声明 的 语法 与 其 他 方法 声明 没有 区 


async 关 键 字 可 以 放 在 返回 类 型 前 的 任意 位 置 。 例 如 以 下 声明 均 合 
法 : 








public static async Task<int> FooAsync() { ... } 
public async static Task<int> FooAsync() { ... } 
async public Task<int> FooAsync() { ... } 

public async virtual Task<int> FooAsync() { ... } 


我 个 人 习惯 把 async 放 在 紧邻 返回 类 型 的 位 置 ， 当 然 ， 读 者 可 以 按 自 己 
的 偏好 来 。 还 是 前 面 提 到 的 那 条 原则 ， 最 好 与 团队 协商 好 编码 风格 ， 并 
尽量 保持 同一 代码 库 内 编码 风格 统一 。 


关于 async 关 键 字 ， 有 一 个 秘诀 : 设计 团队 当初 其 实 并 不 需要 引入 该 关 
键 字 。 编 译 右 在 过 到 yield return 或 者 yield _ break 时， 了 束 会 进入 迭代 器 
块 模 式 。 同 理 ， 当 某 个 方法 中 出 现 了 await 修 饰 符 ， 编 译 器 也 可 以 由 此 
进入 异步 模式 。 不 过 我 认为 强制 要 求 async 关 键 词 的 做 法 是 可 取 的 ， 
为 这 样 做 便于 阅读 使 用 了 异步 方法 的 代码 。 只 要 出 现 async 关 键 词 ， 整 
意味 着 后 面 会 有 await， 继 而 寻找 那些 应 当 转 换 为 async 调 用 搭配 await 表 
达 式 的 阻塞 调用 。 


然而 在 生成 的 下 代码 中 ，async 修 饰 符 被 省 略 了 ， 这 一 点 很 重要 。 对 于 
调用 方法 来 讲 ，async 方 法 不 过 是 一 个 恰好 返回 值 是 task 的 普通 方法 黑 
了 。 我 们 可 以 把 现 有 普通 方法 (方法 签名 合适 ) 改 成 async 方 法 ， 或 者 
反问 操作 。 这 种 改动 是 源码 和 二 进 制 兼容 的 。async 属 于 方法 的 实现 细 
节 ， 因 此 不 能 声明 抽象 方法 或 者 接口 中 的 方法 为 async。 不 过 这 些 方法 
的 返回 值 完 全 可 以 是 Task<int> 类 型 的 ， 它 们 的 具体 实现 可 以 使 

用 async/await， 也 可 以 只 是 普通 方法 。 




















5.3.1 async 方 法 的 返回 类 型 


async 方 法 和 调用 它 的 方法 之 间 通 过 返回 值 进行 交互 。 在 C#5 中 ， 寞 步 函 
数 的 返回 值 仅 限于 以 下 3 个 类 型 





© Void; 
@ Task; 
@ Task<TResult> ( 某 些 TResult 本 身 也 可 以 是 类 型 形 参 ) 


C# 7 新 增 了 一 种 返回 值 类 型 。5.8 节 会 继续 讨论 返回 值 的 问题 ， 第 6 章 也 
会 谈 及 。 


.NET 4 中 的 Task 和 Task<TResult> 类 型 都 表示 某 个 可 能 尚未 执行 完成 的 操 
作 。Task<TResult> 继 承 自 Task。 二 者 的 区 别 在 于 ，Task<TResult> 表 示 
返回 值 为 TResult 类 型 的 操作 ， 而 Task 表 示 没 有 返回 值 的 操作 。 返 回 Task 
类 型 很 有 用 处 ， 因 为 它 允 许 调用 代码 把 目 己 的 续 延 附加 给 返回 的 task， 
检测 该 task 执 行 完成 或 成 功 与 否 ， 等 等 。 有 了 时 可 以 把 Task 看 

作 Task<void>。 


说 明 ” 讲 到 这 里 ，F# 开 发 人 员 完 全 有 理由 为 他 们 的 unit 类 型 而 饭 
乾 。Unit 类 型 与 void 类 似 ， 但 它 是 真实 的 类 型 。Task 

与 Task<TResult> 类 型 之 间 的 差异 让 人 苗 恼 。 如 果 void 可 以 用 作 类 型 
实 参 ， 在 委托 中 加 可 以 省 去 Action 系 列 了 ， 例 如 可 以 使 


用 Func<string， void> 蔡 代 Action<string>。 


async 方 法 之 所 以 可 以 返回 void 类 型 ， 是 为 了 与 事件 处 理 器 兼容 。 例 如 以 
下 UI 按 钮 点 击 的 事件 处 理 器 : 


private async void LoadStockpPrice(object sender, EventArgs e) 

















string ticker = tickerIinput.Text; 
decimal price = await stockPriceService.FetchPpriceAsync(ticke 
priceDisplay.Text = price.ToString("c"); 


} 

这 是 一 个 异步 方法 ， 但 是 调用 方 ( 按 钮 的 onclick 方 法 或 者 其 他 任何 可 
能 触发 事件 的 代码 ) 并 不 在 意 。 调 用 方 不 关心 事件 处 理 何 时 完成 〈 贷 
价格 载 入 完毕 并 更 新 UI 后 ) 。 它 只 是 调用 了 提供 给 自己 的 事件 处 理 器 。 
在 此 过 程 中 ， 编 译 器 将 生成 某 个 状态 机 的 代码 ， 以 及 状态 机 将 续 延 和 
FetchpPriceAsync 的 返回 值 进行 绑 定 等 都 属于 实现 细节 。 

然后 像 对 答 一 般 的 事件 处 理 器 那样 ， 为 该 方法 订阅 该 事件 : 


loadStockPriceButton.Click += LoadStockPrice; 








毕竟 对 于 调用 方 来 说 ， 这 不 过 是 一 个 普通 的 方法 ， 只 是 void 的 返回 类 型 
和 object、EventArgs 的 输入 参数 类 型 ， 使 得 该 方法 能 够 用 于 
EventHandler 委 托 实 例 。 


警告 ”返回 void 类 型 的 异步 方法 最 好 只 用 于 事件 订阅 中 。 对 于 其 他 
不 需要 返回 特定 值 的 情况 ， 把 异步 方法 的 返回 类 型 声明 为 Task 更 
好 。 这 样 调用 方才 能 await 操 作 完 成 、 友 现 操作 失败 ， 等 等 。 


里 然 async 方 法 的 返回 类 型 受到 严格 限制 ， 但 其 他 方面 没有 特殊 要 求 。 
async 方 法 可 以 是 泛 型 、 静 态 或 者 非 豆 态 的 ， 也 可 以 指定 各 种 常规 的 访 
问 修饰 行 ， 不 过 对 于 参数 的 使 用 依然 存在 一 些 限制 。 














5.3.2 ” async 方法 的 参数 


async 方 法 的 参数 不 能 由 out 或 者 ref 修 饰 。 这 是 因为 out 和 ref 参 数 是 用 于 
与 调用 方 交 换 信 息 的 ， 有 时 async 方 法 在 控制 流 返 回 到 调用 方 时 ， 操 作 
可 能 还 未 开始 执行 ， 因 此 引用 参数 可 能 尚未 赋值 。 实 际 情况 可 能 更 诡 
异 : 设想 有 个 局 部 变量 以 ref 的 方式 用 作 async 方 法 的 实 参 ， 结 果 直 到 调 
用 方法 上 自己 都 执行 完毕 了 ， 引 用 变量 可 能 还 未 赋值 。 既 然 这 么 做 不 合 
NE 此 外 ， 指 针 类 型 也 不 能 用 作 async 方 法 的 


声明 完 async 方 法 后 ， 可 以 着 手 编写 方法 体 ， 并 且 使 用 await 来 等 得 异步 
操作 了 。 接 下 来 介绍 await 表 达 式 的 用 途 和 用 法 。 


5.4 ” await 表达 式 


使 用 async 来 声明 方法 则 在 在 方法 内 部 使 用 await 表 达 式 。 除 此 之 外 ， 
async 方 法 的 其 他 部 分 与 普通 方法 无 异 。 所 有 控制 流 都 可 以 正常 使 用 : 
循环 、 异 常 、using 表 达 式 等 。 那 么 await 要 用 在 何 处 ? 它 的 功能 又 是 什 
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await 表 达 式 的 语法 非常 简单 : await 运 算 符 外 加 一 个 可 以 返回 值 的 表达 
式 即 可 。await 运 算 符 可 以 搭配 方法 调用 、 变 量 或 者 属性 使 用 。await 的 
表达 式 不 仅 限 于 简单 的 表达 式 。 可 以 采用 链 式 方法 调用 ， 然 后 使 


用 await 等 竺 结果; 


int result = await foo.Bar().Baz(); 


gE 的 优先 级 比 点 符号 运算 符 的 优先 级 低 ， 因 此 以 上 代码 等 同 


int result = await (foo.Bar().Baz()); 


不 过 await 所 搭配 的 表达 式 也 有 条 件 限制 ， 必 须 是 可 等 每 的 ， 下 面 介 绍 
这 个 所 谓 的 可 等 竺 模式 。 


5.4.1 可 等 待 模式 
可 等 待 模式 用 于 判断 哪些 类 型 可 以 使 用 await 运 算 符 。 图 5-4 是 对 图 5-1 的 


回顾 ， 其 中 第 2 条 边界 关乎 async 方 法 与 其 他 异步 操作 是 如 何 进行 交互 
的 。 可 等 每 模式 是 异步 操作 的 定义 基础 。 





图 5-4 可 等 待 模式 允许 async 方 法 异步 地 等 待 操 作 执行 完成 


读者 可 能 会 认为 这 种 模式 需要 通过 接口 来 表达 ， 比 如 使 用 using 表 达 式 
时 ， 编 译 器 要 求 必须 实现 IDisposable 接 口 ， 实 际 上 它 是 基于 模式 实现 
的 。 假 设 有 一 个 返回 类 型 为 T 的 表达 式 需 要 使 用 await， 编 译 器 会 执行 以 
下 检查 步骤 。 


。T 必 须 具 备 一 个 无 参数 的 GetAwaiter() 实 例 方法 ， 或 者 存在 T 的 扩展 
方法 ， 该 方法 以 类 型 r 作 为 唯一 参数 。GetAwaiter 方 法 的 返回 类 型 
不 能 是 void， 其 返回 类 型 称 为 awaiter 类 型 。 

@ awaiter 类 型 必须 实现 system.Runtime.INotifycompletion 接 口 ， 该 
接口 中 只 有 一 个 方法 : void OnCcompleted(Action).。 

。 awaiter 类 型 必须 具有 一 个 可 读 的 实例 属性 Iscompleted， 其 类 型 
为 boo1。 

。 awaiter 类 型 必须 具有 一 个 非 泛 型 、 无 参数 的 实例 方法 GetResult。 

。 上 述 成 员 不 必 为 public， 但 是 这 些 成 员 需 要 能 被 调用 await 的 async 方 
法 访问 到 。《 因 此 存在 这 样 的 可 能 性 : 对 于 茶 个 类 型 ， 在 茶 些 代码 
下 但 在 其 他 代码 中 不 可 行 ， 不 过 这 种 情况 十 分 罕 
见 。) 


如 果 类 型 T 满 足 所 有 上 述 条 件 ， 束 可 以 使 用 await 运 算 符 了 。 不 过 除 此 以 
外 ， 编 译 器 还 需要 另外 一 点 信息 来 决定 await 表 达 式 的 类 型 。 该 类 型 取 
决 于 GetResult 方 法 的 返回 类 型 。 GetResult 方 法 可 以 是 void 返回 类 型 ， 
此 时 await 表 达 式 就 被 视 为 无 结果 表达 式 ， 如 同 表 达 式 直接 调用 某 

个 void 方法 一 样 。 GetResult 的 返回 类 型 不 是 void， 那么 await 表 达 式 的 
返回 类 型 与 GetResult 保 持 一 致 。 


下 面 以 静态 方法 Task.Yield() 为 例 解 释 上 述 规则 。 与 Task 中 其 他 多 数 方 
法 不 同 ，Yield( ) 方 法 本 身 不 返回 某 个 task， 而 返回 YieldAwaitable。 简 
化 版 的 代码 如 下 : 


public class Task 

















public static YieldAwaitable Yield(); 
} 


public struct YieldAwaitable 
public YieldAwaiter GetAwaiter(); 


public struct YieldAwaiter : INotifyCompletion 


public bool IsCompleted { get; } 
public void OnCompleted(Action continuation); 
public void GetResult(); 


. 


可 见 YieldAwaitable 符 合 前 面 所 说 的 可 等 待 模式 的 规则 ， 因 此 可 以 编写 
如 下 代码 : 


public async Task ValidPrintYieldPrint() 











{ 
Console.WriteLine("Before yielding"); 
await Task.Yield(); <------ 合法 
Console.WriteLine("After yielding"); 

} 





但 以 下 写法 是 非法 的 ， 因 为 它 试 图 使 用 YieldAwaitable 返 回 的 结 
public async Task InvalidPrintYieldPrint() 
Console.writeLine("Before yielding"); 


var result = await Task.Yield(); <------ 非法 。await 表 达 式 不 生成 
Console.writeLine("After yielding"); 





} 
第 2 行 代码 非法 的 原因 与 下 面 代码 非法 的 原因 相同 : 


var result = Console.WriteLine("WriteLine is a void method"); 
因为 并 没有 生成 结果 ， 所 以 不 能 将 其 赋值 给 茶 个 变量 。 


Task 的 awaiter 类 型 的 GetResult 方 法 的 返回 类 型 为 void， 
而 Task<TResult> 的 awaiter 类 型 的 6etResult 方 法 的 返回 类 型 为 TResult。 


扩展 方法 的 历史 重要 性 


GetAwaiter 之 所 以 也 可 以 是 扩展 方法 ， 主 要 是 由 历史 原因 而 不 是 现 
实 原因 决定 的 。C# 5 是 与 .NET 4.5 同 期 发 布 的 ， 正 是 在 这 一 版 本 
中 ，C# 将 GetAwaiter 方 法 引入 了 Task 和 Task<TResult> 中 。 如 果 
GetAwaiter 必 须 是 根 红 苗 正 的 实例 方法 ， 开 发 人 员 就 不 得 不 继续 使 
用 .NET 4.0; 而 一 旦 支持 扩展 方法 ， 束 可 以 通过 提供 了 这 些 扩展 方 
法 的 NuGet 包 来 实现 Task 和 Task<TResult> 的 异步 化 。 这 样 也 能 让 社 








区 不 用 测试 .NET 4.5 预 览 版 ， 便 能 测试 C# 5 编译 器 。 


如 今 framework 中 的 代码 ， 早 已 具备 相应 的 GetAwaiter 方 法 ， 因 此 以 
后 几乎 不 再 需要 通过 扩展 方法 来 为 某 个 类 型 添加 可 等 待 属性 了 。 


5.6 节 会 详细 介绍 异步 方法 的 执行 流程 ， 以 及 可 等 待 模式 下 成 员 的 用 
法 。 关 于 await 表 达 式 ， 还 有 香干 限制 条 件 。 


5.4.2 ”await 表 达 式 的 限制 条 件 


类 似 于 yield return，await 表 达 式 的 使 用 场景 也 存在 限制 。 一 个 明显 的 
限制 是 它 只 能 用 于 async 方 法 或 者 异步 匿名 函数 中 〈5.7 节 会 讲 到 ) 。 即 
便 是 在 async 方 法 中 ， 也 不 能 将 await 随 便 用 于 匿名 函数 ， 除 非 该 匿名 函 
数 也 是 异步 的 。 


此 外 ，await 运 算 符 也 不 能 用 于 非 安全 的 上 下 文中 。 不 过 这 并 不 代表 在 
async 方 法 中 不 能 使 用 非 安全 代码 ， 只 是 在 async 方 法 的 非 安全 代码 中 不 
能 使 用 await 运 算 符 而 已 。 代 码 清 单 5-3 展 示 了 一 上 段 精心 设计 的 代码 ， 这 
段 代码 中 有 一 个 指针 负责 裔 历 字 符 串 中 的 字符 ， 最 后 计算 出 其 中 UTF- 

16 编 码 单元 的 数量 。 这 上段 代码 本 映 实 际 意义 不 大 ， 但 它 展 示 了 如 何在 

async 方 法 中 使 用 非 安全 的 上 下 文 。 


代码 清单 5-3 ”在 async 方 法 中 使 用 非 安 全 代码 


static async Task DelaywWithResultofUnsafeCode(string text) 


























int total = 0; 
unsafe <------ async 方 法 中 可 以 有 非 安全 的 上 下 文 








fixed (char* textPointer = text) 


char* p = textPointer; 
while (*p != 0) 


total += *p; 





P++7 
} 
} 
} 
Console.writeLine("Delaying for " + total + "ms"); 
await Task.Delay(total); <------ 但 是 await 表 达 式 不 能 位 于 非 安 全 的 上 


Console.writeLine("Delay complete"); 


} 


另外 ， 在 锁 中 也 不 能 使 用 await 运 算 符 。 如 果 需 要 在 锁 中 等 待 某 个 异步 
操作 ， 那 么 应 该 考虑 重新 设计 代码 。 不 要 手动 通过 try/finally 块 调 
用 Monitor.TryEnter 和 Monitor .Exit 来 绕 过 编译 器 的 限制 ， 而 应 调整 代 
码 来 避免 这 种 情况 发 生 。 如 果实 际 情况 确实 特殊 ， 也 请 考虑 使 

用 semaphoreslLim 的 waitAsync 方 法 来 代 蔡 。 


lock 语 句 中 使 用 的 monitor， 只 能 由 请 求 它 的 同一 线程 来 释放 。 这 样 就 不 
会 出 现 执行 await 表 达 式 之 前 代码 的 线程 ， 与 执行 await 表 达 式 之 后 代码 
的 线程 不 同 这 种 情况 。 即 便 可 以 保持 操作 前 后 的 线程 不 变 《〈 例 如 在 GUI 
同步 线程 中 ) ， 同 一 线程 中 的 其 他 代码 也 有 可 能 进入 lock 语 句 使 用 同一 
个 monitor。 这 显然 不 理想 。1lock 语 句 和 异步 很 难 兼容 。 


还 有 一 些 上 下 文 ， 在 C# 5 中 不 能 使 用 await 运 算 符 ， 不 过 到 了 C# 6 解禁 
了 。 





。 上 所 有 带 有 catch 块 的 try 块 。 
e。 所 有 catch 块 。 
。 所 有 finally 块 。 


在 一 个 仅 搭配 有 finally 块 的 try 块 中 使 用 await 运 算 符 一 直 是 可 行 的 ， 即 
可 以 在 using 语 句 中 使 用 await。C# 设 计 团队 在 C# 5 发 布 之 前 ， 没 想 好 如 
何 安全 可 靠 地 在 上 述 上 下 文中 使 用 await 表 达 式 。 这 为 异步 编程 带 来 了 

些许 不 便 。 在 设计 C# 6 时 他 们 找到 了 正确 构建 状态 机 的 方式 ， 因 此 C# 6 
解除 了 上 述 限 制 。 


前 面 介 绍 了 如 何 声明 async 方 法 以 及 await 运 算 符 在 其 中 的 用 法 。 那 么 当 
异步 操作 执行 完成 后 呢 ? 下 面 介 绍 返 回 值 是 如 何 返 回 给 调用 方 的 。 


5.5 返回 值 的 封装 


前 面 介 绍 了 调用 方 和 async 方 法 之 间 边 界 的 声明 ， 以 及 如 何在 async 方 法 
中 等 竺 异步 操作 。 下 面 讨 论 图 5-4 中 第 1 条 边界 的 问题 : 如 何 使 用 返回 语 
句 返 回 值 给 调用 方 ， 参 考 图 5-5。 








图 5-5 async 方 法 返回 值 给 调用 方 


前 面 举 过 一 个 带 有 返回 数据 的 例子 ， 再 来 回顾 一 下 。 这 次 只 重点 关注 返 
回 。 以 下 内 容 来 自 代 码 清单 5-2: 


static async** Task<int> **GetPageLengthAsync(string uril) 











Task<string> fetchTextTask = client.GetStringAsync(ur1); 
int length = (await fetchTextTask).Length; 
return length; 


ly 


length 的 类 型 是 int， 但 是 方法 的 返回 类 型 是 Task<int>。 编 译 器 生成 的 
代码 负责 封装 数据 ， 因 此 调用 方 最 终 得 到 的 还 是 Task<int> 类 型 值 。 当 

操作 完成 后 ， 该 返回 值 将 包含 最 终 的 数据 值 。 一 个 返回 非 泛 型 Task 的 方 
法 与 一 个 普通 的 void 方 法 没有 区 别 : 都 不 需要 return 语 名 ;如 果 

有 return 语 句 ，return 后 面 不 能 有 任何 具体 的 值 ， 只 能 是 return 本 里 。 

Se task 都 能 够 捕获 async 方 法 中 抛 出 的 异常 (5.6.5 节 会 详 
述 ) 。 





希望 读者 对 于 封装 返回 值 的 必要 性 有 了 一 些 直观 的 理解 。 几 乎 可 以 肯 

定 ， 在 async 方 法 执行 到 return 语 句 之 前 ， 它 就 已 经 将 控制 流 返 回 给 调用 
方 ， 并 以 茶 种 方式 将 相关 信息 提供 给 了 调用 方 。Task<TResult>〈 计 算 

机 科学 中 的 future 概 念 ) 表示 的 是 对 未 来 某 个 值 或 者 异常 的 承诺 。 


对 于 一 般 的 代码 执行 流程 ， 如 果 return 语 句 出 现在 某 个 try 块 中 ， 并 且 

该 try 块 带 有 finally 块 〈using 语 句 也 适用 ) ， 用 于 计算 返回 值 的 表达 式 
会 被 立即 运算 ， 不 过 只 有 当代 码 都 执行 完成 后 ， 才 会 正式 成 为 task 的 结 

果 。 如 果 finally 块 抛 出 异常 ， 那 么 整个 执行 都 会 失败 ， 而 不 是 得 到 一 

个 半 成 功 半 失 败 的 结果 。 


在 此 重申 : 这 种 自动 封装 和 拆 封 的 结合 ， 成 束 了 异步 特性 的 组 合 模式 。 
async 方 法 可 以 轻松 消费 其 他 async 方 法 的 结果 ， 于 是 可 以 使 用 多 个 异步 
小 结构 构建 起 一 个 复杂 的 系统 。 这 种 方式 可 以 参照 LINQ: 在 LINQ 中 ， 

我 们 针对 序列 中 的 单个 元 素 编 写 操作 ， 然 后 通过 封装 和 拆 封 就 能 把 操作 
应 用 于 整个 序列 。 在 进行 异步 编程 时 ， 我 们 很 少 会 显 式 处 理 task， 而 会 
使 用 await 来 消费 task， 然 后 上 自动 产生 一 个 结果 task， 这 些 都 属于 async 方 
法 机 制 的 一 部 分 。 如 何 编写 异步 方法 已 介绍 完毕 ， 下 面 通过 具体 示例 介 
绍 异 步 方 法 的 执行 流程 。 


5.6 ”异步 方法 执行 流程 
对 于 async/await 的 理解 可 以 划分 为 以 下 几 个 层次 。 


。 不 求 其 解 ， 只 寄 希 望 于 await 可 以 顺利 执行 。 

。 研究 代码 的 执行 方式 : 哪个 线程 什么 时 间 发 生 了 什么 操作 ， 但 并 不 
清楚 其 背后 的 实现 原理 。 

。 深入 探 守 整 个 基础 架构 并 了 解 运行 原理 。 


截至 目前 ， 相 关 介 绍 还 都 只 停留 在 第 1 个 层次 ， 偶 和 尔 涉及 第 2 个 层次 。 下 
面 着 重 探讨 第 2 个 层次 ， 介 绍 语言 层面 所 提供 的 功能 。 至 于 第 3 个 层次 ， 
留待 第 6 章 讲 授 ， 届 时 将 介绍 编译 器 的 幕后 工作 。《 即 便 学 完 第 6 音 ， 读 
者 亦 可 继续 癌 更 深 的 层次 进发 。 本 书 不 讨论 蕊 层面 以 下 的 内 容 : 操作 系 
统 和 便 件 层 对 于 异步 和 线程 的 文 持 。) 


在 多 数 开发 工作 中 ， 读 者 可 以 根据 实际 情况 游 走 于 前 两 个 层次 之 间 。 对 
我 而 言 ， 除 非 代码 需要 在 多 个 操作 间 进 行 协作 ， 人 否则 我 也 很 少 考 碟 第 2 




















个 层次 的 细节 ， 一 般 代 码 功能 无 误 即 可 。 重 要 的 是 ， 当 需要 深入 思考 时 
拥有 相关 知识 储备 。 


5.6.1 ”await 的 操作 对 象 与 时 机 


首先 简化 问题 。 有 时 await 是 与 菏 些 方法 调用 链 或 者 茶 个 属性 搭配 使 用 
的 ， 如 下 所 示 : 


string pageText = await new HttpClient().GetStringAsync(url); 


这 种 写法 看 起 来 await 可 以 作用 于 整个 表达 式 。 实 际 上 ，await 只 能 针对 
单一 值 进 行 操作 。 以 上 代码 等 价 于 : 


Task<string> task = new HttpClient().GetStringAsync(ur1); 
string pageText = await task; 


同 理 ，await 表 达 式 的 结果 也 可 以 用 于 方法 实 参 或 者 其 他 表达 式 中 。 再 
次 重申 ， 把 await 和 表达 式 的 其 他 部 分 分 开 来 看 会 有 助 于 理解 。 


假设 有 两 个 方法 : GetHour1LyRateAsync() 和 GetHoursworkedAsync( )， 分 
别 返 回 Task <decimal> 和 Task<int>， 于 是 有 如 下 复杂 语句 : 


AddPayment (await employee.GetHourlyRateAsync() * 
await timeSheet.GetHoursWorkedAsync(employee.Id)); 


按照 C# 表 达 式 的 运算 法 则 ， 会 优先 对 * 左 侧 的 操作 数 进行 运算 ， 然 后 再 
对 右 侧 操作 数 进行 运算 ， 因 此 上 述 语句 可 以 展开 为 : 


Task<decimal> hourlyRateTask = employee.GetHourlyRateAsync(); 
decimal hourlyRate = await hourlyRateTask; 

Task<int> hoursworkedTask = timeSheet.GetHourswWorkedAsync(employe 
int hoursworked = await hoursworkedTastk; 

AddPayment (hourlyRate * hoursworked); 


这 里 不 讨论 编程 风格 。 可 以 把 代码 写成 一 行 ， 也 可 以 展开 成 多 行 ， 只 不 
过 后 者 的 代码 量 会 更 大 ， 但 更 便于 理解 和 调试 。 也 可 以 使 用 第 3 种 写 
法 ， 虽 然 看 起 来 差不多 ， 但 实际 并 不 相同 : 

Task<decimal> hourlyRateTask = employee.GetHourlyRateAsync(); 


Task<int> hoursworkedTask = timeSheet.GetHourswWorkedAsync(employe 
AddPayment(await hourlyRateTask * await hoursworkedTask ); 








这 种 写法 更 易 读 ， 而 且 还 具有 潜在 的 性 能 优势 ，5.10.2 节 会 继续 讨论 这 
天 村 


这 部 分 的 核心 内 容 在 于 找 出 await 的 操作 对 象 和 时 机 。 在 本 例 中 ，await 
的 操作 对 象 是 由 GetHourLyRateAsync 和 GetHoursworkedAsync 返 回 的 
task， 这 两 个 await 操 作 都 发 生 在 AddPayment 方 法 执行 之 前 。 这 一 点 二 良 
置疑 ， 因 为 只 有 先 得 到 两 个 乘 数 的 执行 结果 ， 才 能 把 它们 作为 中 间 结 果 
执行 乘法 ， 最 后 把 乘法 的 执行 结果 作为 AddPayment 的 调用 实 参 。 了 解 了 
0 Ed 
人 质 。 


5.6.2”await 表 达 式 的 运算 


当 执 行 到 await 表 达 式 ， 此 时 有 两 种 可 能 : 异步 操作 已 经 完成 或 尚未 完 
成 。 如 果 操 作 已 经 完成 ， 执 行 流程 继续 即 可 。 执 行 完 成 也 分 两 种 情况 : 
如 果 操 作 失 败 并 且 捕 获 了 表示 失败 的 异常 ， 抛 出 异常 即 可 :; 如果 执行 成 
功 ， 那 么 获取 操作 结果 《例如 从 Task<string> 获 取 string) ， 执 行 流程 
人 
和 王 何 续 延 。 


如 果 异 步 操作 仍 在 进行 ， 情 况 就 复杂 多 了 。 此 时 方法 会 异步 等 待 操作 完 
成 ， 然 后 在 某 个 合适 的 上 下 文中 继续 执行 其 余 代 码 。 其 中 “异步 等 待 ” 意 
味 着 方法 已 经 停止 执行 。 还 需要 给 异步 操作 附加 一 个 续 延 ， 然 后 方法 返 
回 。 异 步 基础 架构 负责 保证 续 延 能 够 在 正确 的 线程 执行 : 通常 是 线程 池 
中 的 线程 〈 特 点 是 线程 之 间 无 差别 ) ， 或 者 是 适当 的 UI 线 程 。 有 具体 采用 
哪个 线程 ， 由 同步 上 下 文 (5.2.2 节 讲 过 ) 决定 ， 并 且 可 以 通过 
Task.ConfigureAwait 来 控制 ，5.10.1 节 会 继续 讨论 。 














返回 与 完成 
描述 异步 行为 时 ， 最 困难 的 应 该 是 区 分 方法 返回 (返回 到 原 调用 方 
或 者 录 个 续 延 ) 和 方法 完成 这 两 个 概念 。 与 多 数 方 法 不 同 ， 寞 步 方 


法 可 以 多 次 返回 ， 当 前 没有 任务 即 可 返回 。 


回 到 之 前 订 比 陡 外 卖 的 那个 例子 ， 假 设 有 EatPizzaAsync 方 法 ， 访 
方法 包含 打 电 话 下 单 、 送 餐 员 上 门 、 比 萨 放疗 一 点 以 及 吃 比萨 一 系 
列 行为 。 每 个 操作 完成 后 ， 方 法 都 可 以 返回 ， 但 只 有 最 后 一 步 吃 比 
萨 完成 后 ， 才 表示 最 终 完成 。 

















从 开发 人 员 的 角度 看 ， 感 觉 就 像 等 待 异 步 操 作 时 方法 暂 集 了 。 编 译 如 可 
以 保证 在 续 延 执行 前 后 ， 方 法 中 的 所 有 局 部 变量 的 值 都 保持 一 怪 ， 束 如 
同和 迭代 塔 块 那样 。 


针对 上 述 情 况 ， 看 一 个 具体 的 例子 。 假 设 有 一 个 简单 的 console 应 用 ， 该 
应 用 调用 一 个 异步 方法 ， 该 异步 方法 await 两 个 task。 Task.FromResult 总 
是 返回 一 个 已 经 完成 的 task， 而 Task.Delay 需 要 等 到 某 个 固定 的 延迟 之 

后 才 完成 。 





代码 清单 5-4 ”await 完 成 的 task 和 未 完成 的 task 


static void Main() 





{ 
Task task = DemoCompletedAsync(); <------ 调用 async 方 法 
Console.writeLine("Method returned"); 
task.wait(); <------ 阻塞 ， 直 到 task 完 成 
Console.writeLine("Task completed"); 

} 

static async Task DemoCompletedAsync() 

{ 
Console.writeLine("Before first await"); 
await Task.FromResult(10); <------ await 一 个 已 经 完成 的 task 
Console.writeLine("Between awaits"); 
await Task.Delay(1000); <------ await 一 个 尚未 完成 的 task 
Console.writeLine("After second await"); 

} 

代码 执行 结果 如 下 : 


Before first await 
Between awaits 
Method returned 
After second await 
Task completed 


天 于 执行 顺序 ， 有 如 下 几 个 重点 。 








。 async 方 法 在 await 已 完成 的 task 时 不 返回 ， 此 时 方法 还 是 按照 同步 方 


式 执行 。 执 行 结果 的 前 两 行 显示 ， 这 两 行 输出 结果 之 间 没 有 其 他 输 
出 内 容 。 


。 当 async 方 法 await 延 迟 task 时 ，async 方 法 会 立即 返回 。 因 此 Main 方 


法 的 第 3 行 输出 结果 是 Method returned。async 方 法 能 够 得 知 当前 


await 的 操作 尚未 完成 ， 因 此 选择 返回 以 防止 阻塞 。 
。 async 方 法 返回 的 task 只 有 在 方法 完成 后 才 完 成 ， 因 此 Task 
completed 在 After second await 之 后 打印 。 


图 5-6 是 await 表 达 式 的 执行 流程 图 ， 然 而 流程 图 无 法 很 好 地 描述 异步 行 
为 ， 这 是 天 然 的 缺陷 。 

可 以 把 图 5-6 中 的 虚线 部 分 视 作 从 图 最 上 方 伸 过 来 的 。 请 注意 ， 这 里 假 
定 await 表 达 式 有 返回 结果 。 如 果 await 的 对 象 是 Task 之 类 的 值 ， 则 fetch 
result 表 示 检 查 操作 是 否 成 功 完 成 。 














图 5-6 ”await 处 理 流程 图 
现在 停 下 来 稍 作 思考 ， 从 异步 方法 返回 究竟 意味 着 什么 ?有 以 下 两 种 可 


会 忆 
月 上。 


。 目前 是 执行 中 遇 到 的 第 一 个 await 表 达 式 ， 最 初 的 调用 方 还 在 调用 
牢记， 在 真正 需要 等 待 之 前 ， 方 法 一 直 是 以 同步 方式 执行 
人 人 

。 己 处 于 等 待 委 个 操作 完成 期 间 ， 因 此 正 处 于 某 个 被 调 起 的 续 延 之 
中 。 此 时 的 调用 栈 与 方法 刚 开始 执行 时 的 调用 栈 大 不 相同 。 


在 第 1 种 情况 下 ， 最 后 得 到 的 一 般 是 返回 给 调用 方 的 Task 或 
者 Task<TResult>。 显 然 ， 此 时 还 没有 获得 方法 返回 的 结果 ， 也 束 无 法 
得 知 方法 能 否 正 和 完成 〈 不 抛 出 异常 ) 。 鉴 于 此 ， 即 将 返回 的 task 必 须 
































是 未 完成 的 。 


在 第 2 种 情况 下 ， 回 调 方 是 谁 取 决 于 当前 上 下 文 。 例 如 在 Windows Forms 
UI 中 ， 如 果 在 UI 线程 中 调用 某 个 async 方 法 ， 并 且 没 有 主动 切换 出 UI 线 
程 ， 那 么 整个 方法 将 在 UI 线程 中 执行 。 刚 开始 时 ， 调 用 栈 处 于 茶 个 事件 
处 理 器 之 中 或 其 他 调用 方 之 中 ， 然 而 接 下 来 就 会 被 Windows Forms 内 部 
机 制 《通常 是 消息 泵 ) 直接 回调 ， 就 像 使 

用 control.BeginInvoke(continuation) 一 样 。 此 时 ， 调 用 方 (无论 是 
Windows Forms 消 晨 录 、 线 程 池 机 制 或 是 其 他 〉 都 不 关心 当前 task 的 情 
这 。 


温 志 提示 : 在 真正 执行 到 第 一 个 异步 await 表 达 式 之 前 ， 方 法 是 完全 同 
步 执行 的 。 调 用 某 个 异步 方法 与 在 新 线程 中 局 动 新 的 task 不 同 ， 需 要 编 
程 人 员 自 己 来 保证 async 方 法 够 快速 返回 。 虽 然 究 竟 如 何 实现 仍 取 雇 于 
代码 所 处 上 下 文 ， 但 是 确实 需要 尽量 避免 在 async 方 法 中 执行 长 耗 时 的 
阻 竖 任务 ， 应 当 将 其 剥离 到 另 一 个 方法 中 ， 然 后 使 用 Task 将 其 录 步 化 。 


回顾 一 下 await 时 操作 已 经 完成 的 情况 。 读 者 可 能 会 有 这 样 的 疑问 : 对 于 
这 种 能 够 立刻 完成 的 操作 ， 为 什么 不 一 开始 就 采用 同步 的 方式 ， 而 要 大 
费 周 草地 使 用 异步 呢 ? 这 有 点 类 似 于 LINQ 中 对 东 个 序列 调用 count ( ) 方 
法 : 通 间 需要 遇 有 历 序 列 中 的 所 有 元 际 才 能 获得 最 终结 有 末 ， 但 有 时 《比如 
该 序列 是 List<T> 类 型 ) 存在 优化 的 实现 。 因 此 设计 一 种 单一 的 抽象 来 

同时 宁 盖 两 种 可 能 会 更 好 ， 还 能 保证 性 能 。 


考虑 一 个 实际 的 异步 API， 比 如 异步 地 读 取 茶 个 硬盘 文件 的 文件 流 ， 文 
件 中 需要 读 取 的 全 部 数据 很 有 可 能 之 前 〈 比 如 通过 茶 个 ReadAsync 方 
法 ) 就 已 经 从 硬盘 读 取 到 内 存 中 了 ， 此 时 无 须 任何 异步 机 制 就 可 以 立即 
使 用 这 些 数 据 。 再 比如 茶 个 架构 设计 中 有 一 个 缓存 ， 我 们 在 异 步 地 获取 
数据 时 ， 无 论 是 从 内 存 绥 存 获取 【〈 返 回 一 个 已 完成 的 任务 ) ， 还 是 从 外 
部 存储 中 获取 《〈 当 读 取 操作 完成 时 才 标 记 为 完成 的 任务 ) 。 异 步 的 基本 
执行 流程 已 介绍 完毕 ， 下 面 把 可 等 竺 模式 也 纳入 讨论 。 


5.6.3 ”可 等 等 模式 成 员 的 使 用 
5.4.1 节 将 可 等 竺 模式 描述 为 一 种 再 要 实现 的 类 型 ， 可 以 对 该 类 型 的 表达 


式 使 用 await 运 算 符 。 下 面 把 异步 行为 模式 的 几 块 拼图 合 到 一 起 。 图 5-7 
在 图 5-6 的 基础 上 稍 做 扩展 ， 用 可 等 待 模式 答 代 原先 比较 宽泛 的 描述 。 






































图 5-7 通过 可 等 待 模式 处 理 await 


这 样 改写 之 后 读者 可 能 会 有 疑问 :为 什么 设计 得 这 么 复杂 ? 为 什么 需要 
语言 层面 的 支持 ?附加 续 延 比 我 们 想象 的 要 复杂 。 在 简单 情况 下 ， 当 控 
制 流 旺 现 为 纯 线性 时 (执行 任务 、 等 待 、 继 续 执行 、 等 待 .…..) ， 可 将 
续 延 视 作 lambda 表 达 式 也 不 是 很 轻松 ) 。 当 代码 中 包含 循环 、 条 件 分 
支 ， 又 想 把 代码 都 集中 在 一 个 方法 内 ， 情 况 就 会 变 得 非常 复杂 ， 而 此 时 
async/await 可 以 大 显 身 手 。 虽 然 有 人 认为 这 不 过 是 编译 器 层面 的 一 些 语 
法 糖 而 已 ， 但 是 如 果 不 是 编译 器 替 我 们 做 幕后 工作 ， 仅 靠 自己 手动 创建 
续 延 ， 代 码 可 读 性 将 相差 较 大 。 


前 面 讲 的 都 是 操作 成 功 的 情况 ， 如 果 发 生 失 败 该 如 何 处 理 呢 ? 
5.6.4 ”有 异 销 拆 封 


在 .NET 中 ， 通 常 通过 异常 来 表示 失败 。 与 返回 给 调用 方 值 类 似 ， 异 常 处 
理 也 需要 语言 层面 的 额外 支持 。 如 果 await 的 菜 个 异步 操作 失败 ， 它 可 能 
是 其 他 线程 中 早已 失败 的 操作 。 常 规 的 同步 生成 异常 的 方式 此 时 不 再 适 
用 。async/await 的 基础 架构 会 尽量 让 处 理 异 步 失 败 接近 于 处 理 同 步 失 

败 。 如 果 把 失败 看 作 一 种 特殊 形式 的 结果 ， 蜡 津 和 返回 值 的 处 理 束 很 相 























似 了 。5.6.5 闻 将 介绍 如 何 从 异步 方法 中 生成 异常 ， 下 面 先 看 一 下 当 await 
一 个 失败 的 操作 时 会 发 生 什 么 。 


awaiter 的 GetResult() 方 法 表示 如 果 有 返回 值 ， 束 获取 该 

值 ，GetResult() 方 法 也 负责 生成 异步 操作 抛 出 的 异 稼 并 将 其 返回 给 调 
用 方 。 实 际 过 程 更 复杂 ， 因 为 在 异步 世界 中 ， 单 个 Task 可 以 表示 多 个 操 
作 ， 因 此 可 能 导致 多 处 失败 。 下 面 以 Task 和 Task<TResult> 为 例 展开 分 
析 ， 因 为 它们 是 await 操 作 的 常见 类 型 。 


Task 和 Task<TResult> 表 示 失 败 的 方式 如 下 。 


。 当 基 个 操作 失败 时 ， 任 务 的 Status 变 成 Faulted〈 并 且 IsFaulted 的 
值 为 true) 。 

@ Exception 属 性 返回 一 个 AggregateException， 它 包含 导致 任务 失败 
Sd 《可 能 多 个 ) 异常 。 如 采 任 务 没 有 faulted， 则 该 属性 值 
入 Null1) 。 

。 如 果 任 务 最 后 的 状态 为 Faulted，wait() 方 法 会 抛 出 一 
个 AggregateException。 

。 Task<TResult> 〈 也 在 等 竺 完成) 的 Result 属 性 可 能 抛 出 一 


个 AggregateException。 





万 外 ， 可 以 通过 cancellationTokenSource 和 cancellationToken 取 消 任 
务 。 如 果 任 务 取消 了 ，wait() 方 法 和 Result 属 性 会 抛 出 一 

个 AggregateException， 其 中 包含 一 个 operationcanceledException ( 实 
际 上 ， 继承 自 operationcanceleException 的 TaskcanceledException ) ， 
但 它 的 状态 是 canceled 而 不 是 Faulted。 


在 await 某 个 task 时 ， 如 果 其 状态 变 为 faulted 或 者 canceled， 那 么 抛 出 的 异 
名 将 不 是 AggregateException， 而 是 AggregateException 内 部 的 第 一 个 
异常 。 多 数 情况 下 ， 这 就 是 我 们 想 要 的 结果 。 和 异步 特性 的 指导 思想 就 是 
尽量 以 更 接近 同步 编程 的 方式 编写 弄 步 代 码 。 代 码 清 单 5-5 一 次 获取 一 
个 URL 直 到 茶 个 操作 成 功 或 者 URL 取 完 。 


代码 清单 5-5 ”获取 网 页 时 捕获 异常 
async Task<string> FetchFirstSuccessfulAsync(IEnumerable<string> 


var client = new HttpClient(); 
foreach (string url in urls) 


try 

return await client,.GetStringAsync(url); <------ 如 果 卢 
a (HttpRequestException exception) <------ 侍 则 捕获 并 打 
Console.writeLine("Failed to fetch {0}: {1}", 
, url, exception.Message); 


throw new HttpRequestException("No URLs succeeded"); 


上 
和 暂 先 忽略 这 段 代码 中 顺序 获取 页 面 和 丢失 原始 异常 的 不 足 ， 这 里 的 重点 


是 捕获 HttpRequestException 的 过 程 。 使 用 Httpclient 尝 试 执行 一 个 异 

步 操 作 ， 如 果 失 败 ， 则 抛 出 HttpRequestException。 我 们 的 目标 是 捕获 
并 且 处 理 该 异常 。 虽 然 愿 望 美 好 ， 但 是 etstringAsync() 调 用 对 于 类 似 
于 服务 器 超时 这 种 错误 不 会 抛 出 HttpRequestException， 因 为 该 方法 只 

是 启动 了 一 个 操作 。 当 它 发 现 错误 时 ， 方 法 早已 经 返回 了 。 它 所 能 做 的 
就 是 返回 一 个 最 终 状 态 为 faulted 的 task， 其 中 包含 一 

个 HttpRequestException。 如 果 只 是 对 该 task 调 用 wait() 方 法 ， 那 么 只 能 
抛 出 一 个 AggregateException， 该 异常 包含 HttpRequestException。 具 

awaiter 的 GetResult 方 法 抛 出 HttpRequestException， 然后 被 catch 块 正 

常 捕获 。 


显然 ， 这 种 方式 会 丢失 信息 。 如 果 在 一 个 状态 为 faulted 的 task 中 有 多 个 
异常 ， 而 GetResult 只 能 抛 出 其 中 一 个 ， 它 只 会 选择 第 一 个 异常 。 读 者 
可 能 希望 重 写 以 上 代码 ， 这 样 当 发 生 失 几时， 调用 方 可 以 捕获 
AggregateException， 然 后 检查 导致 失败 的 所 有 原因 。 某 些 framework 方 
法 确实 会 这 么 做 ， 例 如 Task.whenAlL()， 它 会 异步 地 等 待 多 个 task (在 
方法 调用 中 指定 ) 。 如 果 其 中 任何 一 个 task 失 败 ， 返 回 的 结果 将 包含 所 
有 faulted task 的 异常 。 但 如 果 对 whenA11( ) 返 回 的 task 使 用 await 运 算 符 ， 
就 只 能 得 到 第 一 个 异常 。 如 果 想 查看 异常 的 细节 ， 最 简单 的 做 法 是 对 每 
个 原始 task 都 调用 Task .Exception。 


综 上 所 述 ，awaiter 类 型 的 GetResult() 方 法 可 以 生成 成 功 结果 ， 也 可 以 
生成 异常 。 就 Task 和 Task<TResult> 而 言 ，GetResult() 对 失败 task 的 

AggregateException 进 行 了 拆 封 ， 只 返回 其 内 部 的 第 一 个 异常 。 这 就 解 
释 了 为 何 async 方 法 可 以 消费 男 外 一 个 异步 操作 。 那 么 它 自己 的 执行 结 














果 如 何 生 成 给 调用 方 呢 ? 
5.6.5 ”完成 方法 
首先 回顾 几 个 知识 点 。 


async 方 法 通常 返回 先 于 执行 完成 。 

async 方 法 在 过 到 await 表 达 式 时 ， 如 果 操 作 尚 未 完成 ， 则 立即 返 
回 。 

假设 async 方 法 是 非 void 方法 〈 调 用 方 无 法 知晓 内 部 发 生 的 事情 ) ， 
该 方法 返回 的 值 是 某 个 task 类 型 : C# 7 之 前 的 Task 

或 Task<TResult>， 或 者 C# 7 开始 文 持 的 某 个 目 定 义 task 类 型 〈5.8 节 
会 探讨 ) 。 方 便 起 见 ， 这 里 暂时 假定 其 为 Task<TResult> 类 型 。 

该 task 负 责 指示 async 方 法 如 何以 及 何 时 完成 。 如 有 果 方 法 正 弟 执行 完 
成 ，task 的 状态 会 变 成 RanTocompletion， 并 且 Result 属 性 会 保存 返 
回 值 。 如 果 方 法 体 抛 出 异常 ，task 的 状态 会 变 为 Faulted (或 

者 canceled) ， 然 后 异常 会 被 封装 成 AggregateException， 并 赋值 
给 task 的 Exception 属 性 。 

当 task 状 态 变 为 上 述 任何 一 个 终结 态 ， 与 之 相关 联 的 续 延 〈 例 如 异 
步 方 法 中 await task 的 代码 )〉 束 会 被 安排 执行 。 


鹏 似 重复 的 内 容 


此 时 读者 可 能 会 感觉 目 己 翻 到 了 前 几 页 的 内 容 。 这 些 内 容 和 前 面 讲 
的 await 难 道 不 一 样 吗 ? 


当然 一 样 。 这 里 束 是 要 通过 揪 述 async 方 法 的 执行 流程 ， 来 说 明 
async 方 法 是 如 何 完成 的 ， 而 不 是 说 明 某 个 await 表 达 式 如 何 检查 他 
操作 如 何 完 成 。 如 果 感 觉 两 者 不 一 样 才 奇 怪 呢 ， 因 为 async 方 法 通 
第 都 是 采用 链 式 调用 连接 在 一 起 的 : 在 某 个 async 方 法 中 await 的 值 
很 可 能 是 由 男 一 个 async 方 法 返回 的 。 美 其 名 日 :异步 操作 组 合 。 
以 上 过 程 都 是 编译 器 通过 一 系列 基础 架构 普 我 们 完成 的 。 第 6 章 会 深入 
探究 其 中 的 实现 细节 (当然 ， 由 于 个 人 能 力 所 限 ， 对 这 些 细节 的 介绍 可 
能 无 法 面面俱到 ) 。 本 章 侧 重 于 代码 中 可 取 的 异步 行为 。 


1. 成 功 返回 














执行 成 功 是 最 简单 的 情况 : 如果 async 方 法 声明 为 Task<TResult> 类 
型 ， 返 回 语句 就 需要 返回 一 个 类 型 为 T〈 或 者 可 以 转换 为 TResult 的 
类 型 ) 的 结果 ， 然 后 由 异步 基础 架构 为 task 生 成 结 


如 果 返 回 类 型 是 Task 或 void， 那 么 与 同步 void 方法 类 似 ， 返 回 语句 
只 能 包含 return 而 不 能 包含 任何 具体 的 值 ， 或 者 没有 return 直 接 让 
执行 流程 自然 走 完 。 不 管 是 哪 种 情况 ， 都 无 须 生 成 任何 值 ， 但 需要 
按照 实际 情况 更 新 task 的 状态 。 








. 延迟 异常 和 实 参 校 验 


关于 异常 最 重要 的 一 点 是 ，async 方 法 从 不 直接 抛 出 异常 。 即 便 
async 方 法 执行 的 第 一 步 束 是 抛 出 异常 ， 那 它 也 只 是 返回 一 个 faulted 
task。 (此 时 该 task 立 即 变 为 faulted) 。 这 一 点 会 给 实 参 校 验 来 带 来 
抹 烦 。 假 设 在 某 个 async 方 法 中 ， 需 要 在 校 验 参 数 非 空 之 后 执行 某 
些 操 作 ， 如 果 是 按照 同步 代码 那 种 方式 校 验 参 数 ， 那 么 调用 方 在 开 
始 等 待 task 前 无 法 获取 任何 信息 ， 示 例 见 代码 清单 5-6。 


代码 清单 5-6 。 async 方法 中 失效 的 参数 校 验 


static async Task MainAsync() 

















Task<int> task = ComputeLengthAsync(nuyull); <------ 故意 传 2 
Console.writeLine("Fetched the task"); 

int length = await task; <------ await 结 果 
Console.writeLine("Length: {0}", length); 





} 
static async Task<int> ComputeLengthAsync(string text) 
if (text == null) 
throw new ArgumentNullException("text"); <------ 尽早 # 
a Task.Delay(500); <------ 模拟 真实 的 异步 操作 


return text.Length; 


} 


这 段 代 码 的 执行 结果 是 : Fetched the task 出 现在 失败 之 前 。 因 为 
参数 校 验 在 await 表 达 式 之 前 ， 所 以 会 优先 抛 出 腊 常 ， 而 调用 方 在 
调用 await 之 前 该 异常 对 它 来 说 是 不 可 见 的 。 有 些 参数 校 验 也 可 以 





在 很 短 的 时 间 内 提前 完成 〈 或 者 引发 其 他 异步 操作 ) 。 在 这 种 情况 
下 ， 如 果 能 够 立刻 报告 失败 ， 有 助 于 避免 系统 陷于 后 续 的 错误 。 例 
如 HttpClient,.GetstringAsync 方 法 ， 如 果 给 它 传 入 一 个 nul11 引 用 ， 
它 会 立刻 抛 出 异常 。 


说 明 ”这 一 点 与 迭代 器 方法 中 的 参数 校 验 需 求 类 似 。 虽 然 并 不 
完全 相同 ， 但 都 是 实现 相似 的 效果 。 在 迭代 器 块 中 ， 方 法 中 的 
所 有 代码 ， 在 第 一 个 MoveNext() 调 用 之 前 都 不 会 被 执行 。 在 
async 方 法 中 ， 即 便 立 即 执行 参数 校 验 ， 但 是 如 果 不 调 

用 await， 异种 就 不 会 暴露 出 来 。 


对 这 个 问题 无 须 太 过 忧虑 。 积 极 的 参数 校 验 在 很 多 情况 下 属于 锦 上 
应 化 。 如 今 我 在 编码 中 不 再 循规蹈矩 而 转 问 实 用 主义 。 多 数 时 候 这 
种 时 间 差 并 非 不 可 容忍 。 但 是 如 末 需 要 从 一 个 返回 task 的 方法 中 同 
步 抛 出 异常 ， 有 3 种 方法 可 以 实现 。 这 3 种 方法 本 质 上 都 是 相同 的 ， 
仅 形式 不 同 。 


基本 思路 是 ， 编 写 一 个 返回 task 的 非 async 方 法 ， 该 方法 负责 实现 参 
数 校 验 马 能 ， 待 校 验 完 成 之 后 调用 另 一 个 异步 函数 。3 种 方法 的 区 
别 体现 在 异步 函数 的 具体 实现 方式 上 : 


o 它 可 以 是 某 个 独立 的 async 方 法 ; 

o 可 以 是 共 个 异步 匿名 函数 〈 稍 后 介绍 ) ; 

o 可 以 是 局 部 async 方 法 〈 从 C# 7 开始 ) 。 
我 个 人 倾 问 于 使 用 最 后 一 种 ， 其 优势 是 不 会 同类 中 额外 引入 新 的 方 
法 ， 也 避免 了 创建 委托 的 麻烦 。 代 码 清单 5-7 展 示 了 第 1 种 方式 ， 
为 第 1 种 方式 不 涉及 任何 新 知识 ， 而 另外 两 种 方式 的 代码 与 之 类 似 
〈 见 随 书 代码 ) 。 这 段 代 码 只 展示 computeLengthAsync 方 法 的 内 
容 ， 调 用 部 分 的 代码 无 须 改 动 。 

代码 清单 5-7 ”使 用 单独 的 方法 实现 积极 的 参数 校 验 


static Task<int> ComputeLengthAsync(string text) <------ 非 as 





























if (text == null) 
{ 
throw new ArgumentNullException("text"); 


} 
return ComputeLengthAsyncImpl(text); <------ 校 验 完成 后 调用 : 


和 


static async Task<int> ComputeLengthAsyncImpl(string text) 





await Task.Delay(500); <------ async 方 法 的 实现 中 假设 无 须 校 验 蕴 
return text.Length; 


}; 


使 用 null 作 为 实 参 调用 computeLengthAsync 方 法 ， 异 常会 以 同步 方 
式 抛 出 ， 而 不 是 返回 一 个 faulted task。 


在 介绍 异步 匿名 函数 之 前 ， 先 简单 介绍 一 下 有 异步 取消 机 制 。 前 面 多 
次 涉及 相关 内 容 ， 下 面 探讨 其 细 市 


. 处 理 取消 
任务 并 行 库 为 .NET 4 引入 了 一 个 统一 的 取消 模型 ， 主 要 依 徘 以 下 两 


个 类 型 : cancellationTokenSource 和 cancellationToken。 其 思路 
是 : 创建 一 个 canceLLlationTokenSsource， 然 后 向 其 请 求 一 

个 cancellationToken， 该 cancellationToken 会 被 传递 给 某 个 异步 
操作 。 我 们 只 能 通过 cancellationTokenSource 来 执行 该 取消 操作 ， 
但 是 取消 操作 会 体现 在 令 牌 上 。 (因此 可 以 把 同一 个 令 牌 传递 给 多 
个 操作 ， 而 不 同 操 作 互 不 干扰 。) cancellationToken 有 多 种 用 法 ， 
常规 用 法 是 调用 ThrowIfCcancellationRequested。 当 令 牌 被 取消 时 
它 只 会 抛 出 operationcanceledException1。 如 果 是 调用 同步 方法 

(例如 Taks,wait) ， 当 任务 被 取消 时 ， 也 会 抛 出 同样 的 异常 。 


C# 编 程 规范 中 没有 规定 取消 机 制 和 异步 方法 之 间 应 当 如 何 交 互 。 根 
据 编 程 规范 ， 如 果 异 步 方法 抛 出 任何 异常 ， 则 方法 返回 的 task 的 状 
态 是 Faulted。Faulted 的 具体 含义 属于 实现 层面 ;但 在 实践 中 ， 如 
果 异 步 方法 抛 出 operationcanceledException (或 者 是 该 异常 的 某 
个 子 类 型 ， 比 如 TaskcanceledException) ， 返 回 的 task 的 状态 束 
是 canceled。 需 要 明确 ， 是 抛 出 异常 的 类 型 (直接 抛 出 


OperationcanceledException, 不 需要 取消 令 牌 ) 决定 了 task 的 状 
太 
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代码 清单 5-8 通过 抛 出 operationcanceledException 来 创建 被 
取消 的 task 


static async Task ThrowCancellationException() 


{ 


throw new OperationCanceledException( ) ， 


Task task = ThrowCancellationException(); 
Console.writeLine(task.Status); 


这 有 段 代码 打印 的 结果 是 canceled 而 不 是 Faulted， 这 和 编程 规范 中 的 
说 法 有 出 入 。 如 果 对 该 task 调 用 wait() 方 法 或 者 向 其 请 求 结果 
(Task<TResult>) ， 那 么 异常 还 是 会 在 AggregateException 内 部 被 


抛 出 ， 因 此 并 不 需要 显 式 地 检查 每 个 任务 是 否 被 取消 。 
苋 态 条 件 


读者 可 能 会 有 疑问 : 代码 清单 5-8 中 是 否 存 在 竞 态 条 件 ? 毕竟 
调用 的 是 一 个 步 方法 ， 然 后 期 竺 它 的 状态 立刻 得 到 修正 。 如 
果 代 码 局 动 了 一 个 新 线程 束 不 妙 了 ， 但 事实 并 非 如 此 。 


请 记 住 ， 在 第 一 个 await 表 达 式 之 前 ， 异 步 方 法 是 以 同步 方式 
执行 的 。 虽 然 它 依然 要 处 理 结 果 和 有 异常 封闭， 但 并 不 因为 它 在 
异步 方法 中 就 一 定 有 多 个 线程 。 ThrowCancellationException 
方法 并 不 包含 await 表 达 式 ， 因 此 整个 方法 实际 上 是 以 同步 方 
式 在 执行 ， 只 是 告诉 我 们 当 它 返回 时 会 给 出 一 个 结果 。 当 遇 到 
不 包含 await 表 达 式 的 异步 函数 时 ，Visual Studio 会 用 出 警告 信 
忆 。 

















如 果 正 在 等 待 的 某 个 操作 被 取消 ， 那 么 原始 的 
operationCcanceledException 会 被 抛 出 。 之 后 除非 采取 某 些 直接 措 
施 ， 人 否则 从 异步 方法 返回 的 task 将 被 取消 。 

读 到 这 里 值得 庆 帝 ， 本 章 最 为 艰深 的 内 容 已 介绍 完毕 。 虽 然 接 下 来 
还 有 若干 特性 需要 学 习 ， 但 比 之 前 的 内 容 要 容易 理解 得 多 。 第 6 章 
的 内 容 又 会 变 得 艰深 ， 届 时 将 剖析 编译 器 的 幕后 工作 ， 不 过 目前 可 
享受 一 段 短暂 的 轻松 。 


1 随 书 代码 中 包含 相关 示例 。 
5.7 异步 匿名 水 数 























关于 异步 匿名 函数 的 介绍 不 会 花费 过 多 篇 幅 。 顾 名 思 义 ， 异 步 匿 名 函数 
由 两 不 特 竹 组 合 而 成 : 匿名 函数 人 和 异步 函 
数 〈 包 含 await 表 达 式 的 代码 ) 。 通 过 异步 匿名 函数 可 以 创建 表示 异步 
的 委托 。 前 面 所 讲 的 关于 异步 方法 的 所 有 知识 都 适用 于 异步 匿名 函 








说 明 不 能 使 用 寞 步 匿 名 函数 来 创建 表达 式 树 。 


创建 异步 匿名 函数 很 简单 ， 形 式 与 创建 匿名 方法 或 lambda 表 达 式 一 样 ， 
在 前 面 加 上 async 即 可 ， 例 如 : 


Func<Task> lambda = async () => await Task.Delay(1000 ) ; 
Func<Task<int>> anonMethod = async delegate() 





Console.writeLine("Started"); 
await Task.Delay(1000); 
Console.writeLine("Finished"); 
return 10; 


}; 


其 中 委托 的 返回 值 类 型 必须 符合 异步 方法 的 要 求 〈C# 5 和 C# 6 文 持 的 
weit. Task 过 者 Taskcresul 闫 型 或 者 C# 7 支持 的 自 定 义 task 类 
与 普 Te 步 匿 名 函数 也 可 以 捕获 变量 、 添 加 参数 
a 另外 ， 步 换 作 直 到 委托 被 调 用 帮会 开始 执行 而 且 多 次 调用 会 创 
建 多 个 操作 。 与 调用 async 方 法 一 样 ，await 结 果 task 并 不 会 启动 操作 ， 而 
是 调用 委托 的 时 候 启 动 操作 ， 对 于 异步 匿名 函数 的 结果 也 不 需要 使 
用 await。 代 码 清单 5-9 稍 微 完 整 一 些 《虽然 依然 没有 实际 意义 : 


代码 清单 5-9 使 用 lambda 表 达 式 创建 和 调用 异步 函数 


Func<int, Task<int>> function = async x => 








{ 
Console.writeLine("Starting... x={0}", x); 
await Task.Delay(x * 1000); 
Console.writeLine("Finished... x={0}", x); 
return x * 2;， 

}; 


Task<int> first = function(5); 

Task<int> second = function(3); 
Console.writeLine("First result: {0}", first.Result); 
Console.writeLine("Second result: {0}", second.Result); 


上 述 例子 所 用 数值 是 特意 选取 的 ， 这 样 第 2 个 操作 可 以 先 于 第 1 个 操作 完 
成 。 但 是 由 于 需要 等 等 第 1 个 操作 完成 才能 打印 最 终结 果 (调用 Result 
属性 的 操作 会 一 十 阻 玲 直到 任务 完成 一 一 再 次 强调 ， 运 行 这 段 代码 时 需 
要 格外 小 心 ) ， 因 此 最 后 代码 运行 结果 为 : 


Starting... 
Starting... 
Finished... 
Finished... 
First result: 
Second result: 6 


2 
一 致 。 


里 然 我 在 工作 中 编写 async 方 法 要 远 多 于 异步 匿名 函数 ， 但 异步 匿名 函 
数 仍 有 着 其 存在 价值 ， 尤 其 体现 在 与 LINQ 搭 配 使 用 时 。 虽 然 无 法 用 于 
LINQ 碍 询 表达 式 中 ， 但 是 可 以 直接 调用 其 等 价 方法 。 有 异步 匿名 函数 也 
有 局 限 性 : 由 于 异步 函数 不 能 返回 bo01 类 型 ， 因 此 它 不 能 与 Where 方 法 
搭配 使 用 。 我 最 常用 的 方法 是 select， 通 过 它 把 某 个 类 型 的 task 序 列 转 
换 成 其 他 类 型 的 task 序 列 。 下 面 介 绍 一 个 前 面 多 次 提 及 的 特性 : C# 7 引 
入 该 特性 ， 将 腊 步 的 普 适 性 推 回 了 新 的 局 度 。 
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5.8  C#7 目 定义 task 类 型 


在 C# 5 和 C# 6 中 ， 有 异步 函数 〈 即 async 方 法 和 有 异步 匿名 函数 ) 只 能 返回 
void、Task 或 Task<TResult>。C# 7 对 于 这 一 限制 有 所 放宽 : 某 些 通过 特 
定 方式 修饰 的 类 型 也 可 以 用 作 异 步 函 数 的 返回 类 型 。 


温 志 提示 : async/await 特 性 一 直人 允许 使 用 await 来 运算 符合 可 等 等 模 式 
的 目 定 义 类 型 。 本 节 所 讨论 的 特性 ， 指 的 是 如 何 为 async 方 法 指定 上 自 定 
义 返 回 类 型 。 


该 特性 既 简单 又 复杂 。 复 杂 性 体现 在 ， 如果 要 自 定义 task 类 型 ， 需 要 烦 
琐 的 编码 工作 ， 非 信念 坚定 者 不 可 为 。 简 单 性 体现 在 ， 基 本 可 以 确定 ， 
除了 实验 目的 ， 基 本 无 须 实现 自 定义 task 类 型 。 我 们 需要 使 用 的 类 型 
是 valueTask<TResult>， 下 面 一 探究 竟 。 














5.8.1 99.9% 的 情况 : valueTask<TResult> 


在 编写 本 章 时 ，System.Threading.ValueTask<TResult> 类 型 还 只 是 在 
netcoreapp2.0 框 架 中 对 外 提供 ， 但 是 NuGet 中 的 
System.Threading.Tasks.Extensions 包 中 包含 该 类 型 ， 故 其 适用 范围 大 
大 扩展 。 (更 重要 的 是 ， 该 包 也 文 持 netstandard1.0。) 





ValueTask<TResult> 与 Task<TResult> 类 似 ， 但 它 是 值 类 

型 。 ValueTask<TResult> 提 供 了 一 个 AsTask 方 法 ， 可 根据 需要 获取 篆 规 
task (例如 用 作 Task .whenA1ll 或 Task .whenAny 调 用 的 某 个 元 素 ) ， 不 过 多 
数 情况 下 只 是 按照 普通 task 那 样 调 用 await 操 作 。 


valueTask<TResult> 相 比 Task<TResult> 优 势 何在 ?其 实体 现在 堆 内 存 分 
配 和 垃圾 回收 上 。Task<TResult> 是 一 个 类 ， 虽 然 有 时 异步 基础 架构 会 
复 用 已 创建 的 Task<TResult> 对 象 ， 但 多 数 async 方 法 需要 创建 新 的 
Task<TResult> 对 象 。 一 般 情 况 下 ，.NET 创 建 对 象 的 性 能 消耗 不 足 为 
0 就 需要 尺 量 避免 创 
建新 对 象 。 


如 果 在 async 方 法 中 对 某 个 尚未 完成 的 操作 使 用 await， 那 么 创建 对 象 是 
不 可 避免 的 。 虽 然 此 时 方法 会 立即 返回 ， 但 它 需 要 安排 一 个 续 延 。 当 操 
作 完 成 时 ， 访 续 延 负责 执行 async 方 法 中 的 其 余 语句 。 大 部 分 async 方 法 
中 的 操作 不 会 在 await 前 执行 完成 。 此 时 使 用 valueTask<TResult> 没 有 任 
何 优势 ， 甚 至 可 能 造成 性 能 有 所 下 降 。 


有 了 时 task 在 await 之 前 便 已 完成 ， 于 是 ValueTask<TResult> 训 有 了 用 武之 
地 。 以 简化 版 的 真实 代码 为 例 ， 假 设 需 要 从 某 个 system.I0.Stream 中 读 
取 数 据 ， 方 式 是 异步 逐 字 节 读 取 。 我 们 自然 会 创建 一 个 缓存 中 间 层 来 避 
免 频 党 调用 底层 Stream 的 ReadAsync 方 法 ， 然 而 还 需要 一 个 async 方 法 来 
负责 把 MO 流 数据 填充 到 缓存 层 ， 然 后 返回 下 一 个 字 节 。 我 们 可 以 

用 byte? 的 nul1 值 来 表示 数据 读 取 已 到 达 末 尾 。 该 方法 本 身 并 不 难 实 
现 ， 但 它 的 每 次 调用 都 会 创建 一 个 Task<byte?> 类 型 的 对 象 ， 这 会 给 垃 
圾 回收 器 融 来 负担 。 如 果 使 用 valueTask<TResult>， 只 有 在 需要 把 流 数 
据 重新 填充 到 缓存 时 才 需 要 扒 内 存 分 配 。 代 码 清 单 5-10 展 示 了 该 封装 类 
型 Bytestream 以 及 调用 它 的 代码 。 


代码 清单 5-10“” 逐 字 节 异步 流 读 取 封 装 


























public sealed class ByteStream : IDisposable 




















{ 
private readonly Stream stream; 
private readonly byte[] buffer ; 
private int position; <------ 待 返回 的 缓冲 区 下 一 个 索引 
private int bufferedBytes; <------ 缓冲 区 读 取 的 字 节 数 
public ByteStream(Stream stream) 
this.stream = stream; 
buffer = new byte[1024 * 8]; <------ 8KB 绥 冲 区 的 大 小 ， 意 味 着 , 
} 
public async ValueTask<byte?> ReadByteAsync ( ) 
{ 
if (position == bufferedBytes) <------ 根据 需要 重新 填充 缓冲 区 
{ 
position = 0; 
bufferedBytes = await 
stream.ReadAsync(buffer, 0, buffer.Length) <----- 
.ConfigureAwait(false); <------ 配置 await 操 
if (bufferedBytes == 0) 
{ 
return null; <------ 指示 已 经 读 取 到 流 的 末尾 
} 
return buffer[position++]; <------ 返回 缓冲 区 中 的 下 一 个 字 节 
} 
public void Dispose() 
{ 
stream.Dispose(); 
} 
} 
# 调用 举例 


Using (var stream = new ByteStream(File.OpenrRead("file.dat"))) 


while ((nextByte = await stream.ReadByteAsync()).HasVvalue) 





ConsumeByte(nextByte.Value); <------ 以 某 种 方式 使 用 字 节 内 容 
} 


暂时 忽略 ReadByteAsync 方 法 中 的 configureAwait 调 用 。5.10 节 介绍 如 何 
提升 async/await 效 率 时 会 探讨 相关 内 容 。 剩 余 代 人 码 承 很 直 白 了 ， 而 且 也 
可 以 不 使 用 valueTask<TResult>， 只 不 过 性 能 会 差 很 多 。 


在 这 个 例子 中 ， 大 部 分 ReadByteAsync 方 法 调用 甚至 不 会 用 到 await 运 算 
符 ， 因 为 可 以 直接 返回 缓存 中 的 数据 。valueTask<TResult> 类 型 对 于 其 
他 可 以 立即 完成 的 操作 也 具有 相同 的 效果 。 如 前 所 述 ， 在 await 一 个 已 经 
完成 的 操作 时 ， 执 行 流程 会 同步 执行 ， 于 是 无 须 安排 续 延 了 ， 也 可 以 避 
免 对 象 的 内 存 分 配 。 


前 面 的 例子 是 oogle.Protobuf 包 中 codedInputstream 类 原型 的 简化 版 
Google.Protobuf 是 Google Protocol Buffers 序 列 化 协议 的 .NET 实现 。 
实际 代码 中 存在 知 干 个 方法 ， 每 个 方法 都 只 负责 读 取 部 分 数据 ， 或 同步 
或 异步 。 对 拥有 多 个 整 型 字段 的 消息 进行 反 序列 化 ， 会 涉及 很 多 异步 方 
法 调用 ， 如 果 每 次 async 方 法 都 返回 Task<TResult> 类 型 ， 那 么 程序 的 执 
行 效率 必然 低下 。 


说 明 读者 可 能 好 奇 ，async 方 法 不 需要 返回 值 (通常 返回 类 型 
为 Task) 的 情况 是 怎样 的 呢 ? 这 种 情况 同样 是 完成 task 且 无 须 安 排 
续 延 。 此 时 依然 可 以 使 用 Task 作 为 返回 类 型 : async/await 基 础 架构 
会 缓存 一 个 task。 访 task 是 一 个 Task 类 型 同步 方法 在 不 抛 出 异常 的 情 
况 下 返回 的 结果 。 如 果 方 法 以 同步 方式 执行 完成 ， 但 是 抛 出 了 异 
常 ， 那 么 为 Task 对 象 分 配 内 存 的 性 能 消耗 与 异常 本 身 所 帝 来 的 开销 
相 比 可 以 忽略 不 计 。 


对 于 大 部 分 开发 人 员 来 说 ， 能 够 使 用 valueTask<TResult> 作 为 async 方 法 
的 返回 类 型 ， 是 C# 7 在 异步 领域 做 出 的 实在 页 献 ， 不 过 C# 7 使 用 了 一 种 
通用 方式 来 实现 ， 这 样 我 们 可 以 通过 它 为 async 方 法 创建 自 定 义 类 型 。 


5.8.2 ” 剩 下 0.1% 的 情况 : 创建 自 定义 task 类 型 


再 次 强调 : 绝 大 部 分 读者 不 需要 了 解 这 部 分 内 容 。 对 于 这 部 分 内 容 ， 找 
不 到 比 valueTask<TResult> 更 具体 的 实例 了 。 为 了 保证 本 书 的 完整 性 ， 
还 需要 阐述 编译 器 判断 task 类 型 的 机 制 。 第 6 章 会 继续 探讨 该 机 制 的 细 
节 ， 届 时 会 展示 async 方 法 经 过 编译 右 生 成 之 后 的 代码 。 


显然 ， 自 定义 task 类 型 必须 实现 可 等 竺 模式， 但 除 此 之 外 还 有 很 多 要 

求 。 创 建 自 定 义 task 类 型 ， 需 要 编写 一 个 相应 的 builder (构造 者 ) 类 

型 ， 然 后 使 

用 System.Runtime.CompilerServices.AsyncMethodBuilderAttribute 来 
告诉 编译 器 这 两 个 类 型 之 间 的 关系 。 该 attribute 是 由 NuGet 提 供 的 ， 














与 ValueTask<TResult> 位 于 同一 个 包 中 。 如 果 不 想 添 加 额外 的 依赖 关 
系 ， 可 以 自行 声明 并 引用 该 attribute (放置 在 合适 的 命名 空间 下 并 且 包 
侣 合适 的 BuilderType 属 性 ) ， 这 样 就 能 成 为 编译 器 认可 的 装饰 task 类 型 
Ts 


该 task 类 型 可 以 是 某 个 类 型 形 参 的 泛 型 或 非 泛 型 。 如 果 是 泛 型 ， 那 么 其 
类 型 形 参 必须 是 awaiter 类 型 的 GetResult 类 型 ， 如 果 是 非 泛 型 ， 那 

么 GetResult 的 返回 类 型 必须 是 void2。 而 builder 必 须 是 与 之 对 应 的 泛 型 
或 非 泛 型 。 


2 这 一 点 首 让 我 颇 感 许 异 ， 它 意味 着 无 法 编写 返回 如 string 类 型 操作 的 
task 关 型 。 不 过 目 定 义 task 类 型 本 身 只 是 一 个 很 小 的 特性 ， 所 以 实际 需 
要 这 样 边 缘 化 用 例 的 可 能 性 也 相当 小 。 


这 里 builder 类 型 正 是 编译 器 和 代码 进行 交互 的 地 方 ， 当 编译 处 理 到 一 个 
返回 目 定 义 类 型 的 方法 时 ， 它 需要 知道 如 何 创建 该 目 定 义 task， 是 填充 
完成 还 是 民利 ， 在 东 个 续 延 之 后 恢复 执行 等 待 ， 为 此 需要 提供 的 方法 集 
以 及 各 个 属性 要 比 实现 可 等 待 模式 复杂 得 多 。 代 码 清单 5-11 是 天 于 具体 
提供 哪些 成 员 的 一 个 完整 实例 ， 不 过 其 中 并 不 包含 具体 的 实现 部 分 。 


代码 清单 5-11 某 泛 型 task 类 型 所 需 成 员 的 主体 代码 


[AsyncMethodBuilder(typeof(CustomTaskBuilder<>) )] 
public class CustomTask<T> 





























public CustomTaskAwaiter<T> GetAwaiter(); 


} 


public class CustomTaskAwaiter<T> : INotifyCompletion 


{ 
public bool IsCompleted { get; } 
public T GetResult(); 
public void OnCompleted(Action continuation); 


} 


public class CustomTaskBuilder<T> 
public static CustomTaskBuilder<T> Create(); 


public void Start<TStateMachine>(ref TStateMachine stateMachi 
where TStateMachine : IAsyncStateMachine; 


public void SetStateMachine(IAsyncStateMachine stateMachine); 
public void SetException(Exception exception); 
public void SetResult(T result); 


public void AwaitOnCompleted<TAwaiter, TStateMachine> 
(ref TAwaiter awaiter, ref TStateMachine stateMachine) 
where TAwaiter : INotifyCompletion 
where TStateMachine : IAsyncStateMachine; 


public void AwaitUnsafeOnCompleted<TAwaiter, TStateMachine> 
(ref TAwaiter awaiter, ref TStateMachine stateMachine) 
where TAwaiter : INotifyCompletion 
where TStateMachine : IAsyncStateMachine; 


public CustomTask<T> Task { get; } 
} 


这 段 代 码 展示 了 某 个 泛 型 自 定 义 task 类 型 。 非 泛 型 自 定义 task 类 型 与 以 
上 代码 的 唯一 区 别 是 ，builder 的 setResult 方 法 是 无 参数 的 。 


这 里 有 一 个 要 求 很 有 意思 : AwaitUnsafeonCompleted 方 法 。 第 6 章 会 讲 
到 ， 编 译 器 有 安全 等 竺 和 非 安 全 等 待 两 个 概念 ， 而 后 者 依赖 可 等 竺 类 型 
来 处 理 上 下 文 的 生成 。 一 个 自 定 义 task builder 类 型 必须 处 理 两 种 等 待 的 
恢复 执行 。 


说 明 非 安 全 这 个 术语 与 unsafe 关 键 字 没有 直接 关系 ， 尽 管 二 者 都 
表示 “小 心 危 人 


再 重申 一 裔 : 可 以 肯定 ， 除 了 兴趣 驱使 ， 几 乎 不 需要 自己 实现 自 定 义 
task 类 型 。 将 来 我 也 不 会 在 产品 代码 中 使 用 自 定 义 task 类 型 ， 而 肯定 会 
使 用 valueTask<TResult>， 不 过 这 个 特性 本 身 依然 可 圈 可 点 。 


说 到 有 用 的 新 特性 ，C# 7.1 还 有 一 个 特性 值得 一 提 ， 而 且 这 个 特性 比 目 
定义 task 类 型 简单 多 了 。 

















5.9 C#7.1 中 的 异步 Main 方 法 
C# 语 言 中 程序 入 口 方法 一 直 以 来 都 有 如 下 要 求 : 


。 方法 名 必须 是 Main; 
。 必须 为 静态 ; 








e 返回 类 型 必须 是 void 或 者 int; 


。 必须 是 无 参 方法 或 者 只 能 有 一 个 string[] 类 型 的 参数 〈 不 能 是 ref 
和 out 参 数 ) ; 


。 必须 是 非 泛 型 并 且 在 一 个 非 泛 型 类 中 声明 〈 如 果 是 藤 套 类 ， 那 么 涉 
及 的 类 也 必须 都 是 非 泛 型 ) ; 

。 不 能 是 没有 实现 的 局 部 类 ; 

。 不 能 有 async 修 饰 符 。 
从 C# 7.1 开 始 ， 废 止 了 最 后 一 条 要 求 ， 同 时 略微 修改 了 对 返回 类 型 的 要 
求 。 在 C#7.1 中 ， 可 以 编写 async 入 口 方法 (方法 名 依然 是 Main 不 
是 MainAsync) ， 但 其 返回 类 型 必须 是 Task 或 者 Task<int>， 对 应 同 
步 Main 方 法 的 void 和 :int 返 回 类 型 。 不 同 于 大 部 分 方法 ， 异 步 Main 方 法 的 
返回 类 型 不 能 是 void， 也 不 能 使 用 自 定义 task 类 型 。 
除 此 之 外 ， 它 只 是 普通 的 async 方 法 。 例 如 代码 清单 5-12 中 的 async 入 口 
方法 就 是 在 控制 侣 打印 两 行 输出 ， 两 次 打印 之 间 有 延迟 。 

代码 清单 5-12 一 个 简单 的 入 口 方法 


static async Task Main() 








Console.WriteLine("Before delay"); 
await Task.Delay(1000); 
Console.WriteLine("After delay"); 


} 


编译 器 在 处 理 该 async 入 口 方法 时 ， 会 创建 一 个 同步 的 封装 方法 ， 该 封 

装 方法 作为 程序 集 真 正 的 入 口 方法 。 封 装 方法 依然 满足 前 面 所 说 的 几 个 
要 求 : 无 参数 或 者 只 有 一 个 string[] 参 数 ， 返 回 值 类 型 是 void 或 

者 int (取决 于 async 方 法 的 参数 和 返回 值 类 型 )。 封 装 方 法 会 调用 这 上段 
代码 ， 然 后 对 返回 的 task 调 用 GetAwaiter()， 并 且 在 awaiter 上 调 

用 GetResult() 方 法 。 封 装 方法 的 代码 如 下 : 


static void <Main>() <------ 方法 的 名 称 在 C# 中 是 非法 的 ， 但 在 IL 中 是 合法 的 











Main().GetAwaiter().GetResult(); 





async 入 口 方 法 对 于 编写 某 些 小 型 工具 或 者 探究 异步 API 的 代码 来 说 是 很 
方便 的 特性 。 


以 上 就 是 异步 特性 在 语言 层面 的 全 部 内 容 ， 不 过 知道 语言 的 用 途 并 不 等 
于 实际 掌握 了 用 法 。 对 于 异步 问题 来 说 更 是 如 此 ， 因 为 异步 问题 有 其 天 
然 的 复杂 性 。 


5.10 ”使 用 建议 


本 节 内 容 不 能 作为 高 效 使 用 异步 特性 的 完全 指南 ， 人 否则 需要 再 写 一 本 

书 。 本 章 篇 幅 已 经 很 长 了 ， 因 此 本 节 压 缩 了 内 容 ， 根 据 我 的 个 人 经 验 给 
出 一 些 重要 的 使 用 建议 。 强 烈 建议 读者 从 其 他 开发 人 员 处 借鉴 学 习 ， 特 
别 是 Stephen Cleary 和 Stephen Toub， 二 人 写 了 很 多 关于 异步 话题 的 博 

文 ， 这 些 文章 深入 探讨 了 异步 的 某 些 方面 。 下 面 列举 一 些 有 用 的 建议 ， 
这 些 建 议 的 重要 性 不 分 先后 。 


5.10.1 使 用 configureAwait 避 免 上 和 下文 捕获 〈 择 机 使 用 ) 


5.2.2 节 和 5.6.2 节 介绍 了 同步 上 下 文 及 其 对 await 运 算 符 的 影响 。 例 如 在 
WPF 或 者 Windows Forms 的 某 个 UI 线 程 中 ， 如 果 存 在 对 某 个 异步 操作 的 
await， 那 么 UI 同 步 上 下 文 和 异步 基础 架构 会 确保 在 await 运 算 符 之 后 ， 

续 延 能 够 在 同一 个 UI 线 程 中 运行 。 这 样 的 设计 符合 我 们 对 于 UI 代 码 的 要 
求 ， 因 为 可 以 确保 之 后 安全 地 访问 UI 元 素 。 


但 如 果 编 写 的 是 库 代码 或 者 不 涉及 UI 操作 的 应 用 程序 ， 就 不 需要 再 返回 
到 UI 线程 ， 即 便 操 作 最 初 是 在 UI 线程 中 执行 的 。 一 般 而 言 ， 应 当 尺 量 减 
少 在 UI 线程 中 执行 代码 ， 以 保证 UI 更 新 更 平顺 ， 也 可 以 避免 UI 成 为 性 能 
瓶颈 。 当 然 ， 如 果 编 写 的 是 UI 库 ， 那 之 后 可 能 还 需要 返回 到 UI 线程 ， 但 
是 对 于 大 部 分 库 来 说 ， 比 如 业务 逻辑 、Web 服 务 、 数 据 库 访问 等 ， 不 需 
要 再 返回 到 UI 线 程 。 


configureAwait 方 法 就 是 用 于 完成 此 项 任务 的 。 它 接收 一 个 参数 ， 该 参 
数 决 定 返回 的 可 等 竺 在 等 待 时 是 否 需要 捕获 上 下 文 。 到 目前 为 止 ， 我 所 
人 于 是 此 前 用 于 获取 页 面 长 度 的 代码 可 以 淘 
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static async Task<int> GetPageLengthAsync(string url]l) 


€ 












































var fetchTextTask = client.GetStringAsync(ur1l); 
int length = (await fetchTextTask) .Length ; 
i 假设 这 里 还 有 更 多 代码 





return Jength ; 


人 


可 以 对 client.GetstringAsync(ur1L) 返 回 的 task 调 
用 configureAwait(false)， 然 后 await 结 果 : 


static async Task<int> GetPageLengthAsync(string Url) 
var fetchTextTask = client.GetStringAsync(url1).ConfigureAwait 


int length = (await fetchTextTask) .Length ; 
ee 假设 这 里 还 有 更 多 代码 





return length; 


简单 起 见 ， 其 中 fetchTextTask 使 用 了 隐 式 类 型 。 在 第 1 个 例子 中 ， 它 的 
类 型 为 Task<int>; 在 第 2 个 例子 中 ， 它 的 类 型 

为 configuredTaskAwaitable<int>。 不 过 我 遇 到 的 大 部 分 代码 直接 await 
返回 值 : 


string text = await client.GetStringAsync(url).ConfigureAwait(fal 


调用 configureAwait(false) 的 结果 是 不 会 把 续 延 安排 到 最 初 的 同步 上 下 
文中 执行 ， 而 是 为 它 安排 一 个 线程 池 的 线程 。 注 意 ， 只 有 await 的 task 还 
未 完成 时 ， 两 段 代码 的 行为 才 有 区 别 。 如 果 task 已 经 完成 ， 那 么 方法 会 
以 同步 方式 继续 执行 ， 无 论 是 否 使 用 了 configureAwait(false)。 因此 ， 
库 中 每 个 await task 都 应 当 以 此 进行 配置 ， 不 能 指望 只 对 async 方 法 的 第 
一 个 task 使 用 configureAwait(false) 之 后 ， 其 余 代 码 就 都 能 在 线程 池 线 
程 中 执行 了 。 


编写 库 代 码 时 需 小 心 刘 慎 。 我 认为 最 终 可 能 会 有 汞 个 更 优 的 解决 方 采 
《比如 可 以 对 整个 程序 集 进行 默认 设置 ) ， 但 目前 仍 需 小 心 行事 。 建 议 
使 用 Roslyn 分 析 器 来 探查 代码 中 遗漏 配置 之 处 。 我 对 NuGet 包 提供 的 
ConfigureAwaitchecker.Analyzer 个 人 体验 良好 ， 当然 读者 也 可 以 选择 
其 他 工具 。 


读者 可 能 会 担心 这 样 的 配置 会 对 调用 方 有 什么 影响 ， 不 必 多 虑 。 假 设 调 
用 方正 在 await 由 GetPageLengthAsync 返 回 的 task， 并 且 需 要 根据 结果 更 
新 UI。 即 使 eetpageLengthAsync 内 部 的 续 延 需要 在 线程 池 线程 中 运行 ， 
UI 代码 中 的 await 表 达 式 也 能 够 捕获 UI 的 上 下 文 ， 然 后 安排 自己 的 续 延 
在 UI 线程 中 执行 ， 这 样 在 task 完 成 之 后 UI 仍然 可 以 正常 更 新 。 








5.10.2 ”启动 多 个 独立 task 以 实现 并 行 


5.6.1 节 通过 多 种 方式 实现 同一 个 功能 : 根据 雇员 的 时 新 和 实际 工作 时 长 
计算 应 发 工资 ， 最 后 两 段 代 码 如 下 : 


Task<decimal> hourlyRateTask = employee.GetHourlyRateAsync(); 
decimal hourlyRate = await hourlyRateTask; 

Task<int> hoursworkedTask = timeSheet.GetHourswWorkedAsync(employe 
int hoursworked = await hoursworkedTastk; 

AddPayment (hourlyRate * hoursworked); 


以 及 


Task<decimal> hourlyRateTask = employee.GetHourlyRateAsync(); 
Task<int> hoursworkedTask = timeSheet.GetHourswWorkedAsync(employe 
AddPayment(await hourlyRateTask * await hoursworkedTask ) 


第 2 段 代 码 除 了 更 简短 ， 还 引入 了 并 行 的 能 力 。 这 两 个 task 可 以 分 别 局 
动 ， 因 为 二 者 之 间 不 存在 结果 依赖 。 不 过 这 并 不 是 说 异步 基础 洋 构 需要 
创建 更 多 线程 。 如 果 两 个 异步 操作 是 Web 服 务 ， 那 么 这 两 个 服务 请 求 可 
以 同时 处 于 等 待 啊 应 状态 ， 而 线程 不 会 被 阻塞 。 


这 样 ， 代 码 简短 的 优势 反而 成 了 次 要 的 。 如 果 既 想 使 用 独立 变量 ， 又 想 
保持 并 行 执 行 ， 也 是 可 以 实现 的 : 


Task<decimal> hourlyRateTask = employee.GetHourlyRateAsync(); 
Task<int> hoursworkedTask = timeSheet.GetHourswWorkedAsync(employe 
decimal hourlyRate = await hourlyRateTask; 

int hoursworked = await hoursworkedTastk; 

AddPayment (hourlyRate * hoursworked); 


这 上 段 代 码 和 第 1 段 代 码 的 区 别 是 ， 第 2 行 和 第 3 行 互 换 了 位 置 。 原 先 代码 
是 先 await hourlyRateTask, 然后 启动 hoursworkedTask， 互 换 位 置 之 后 
就 变 成 了 同时 启动 并 await 两 个 task。 


多 数 时 候 ， 应 当 尽 可 能 并 行 执行 独立 的 task。 需 要 注意 的 是 ， 如 果 
hourlyRateTask 失 败 了 ， 就 不 会 去 检查 hoursworkedTask 的 结果 (是 否 失 
败 ) 。 如 果 想 记录 所 有 task 的 失败 结果 ， 则 需要 使 用 Task.whenA1l1。 


当然 ， 这 种 并 行 是 以 各 个 task 相 互 独立 执行 为 条 件 的 。 有 时 这 种 依赖 天 
系 并 不 明显 。 假 设 有 一 个 task 征 为 用 户 授权 ， 妃 一 个 task 是 以 该 用 户 的 


























身份 执行 某 些 操作 ， 那 就 需要 等 到 用 户 授 权 检 查 完成 后 才能 执行 后 续 操 
作 ， 这 时 就 无 法 实现 并 行 操作 了 。async/await 特 性 本 身 无 法 判断 哪些 操 
作 可 以 并 行 执行 ， 需 要 编程 人 员 上 自行 判断 ， 但 async/await 特 性 有 助 于 人 简 
化 这 一 过 程 。 


5.10.3 ”避免 同步 代码 和 异步 代码 混用 


虽然 同步 模式 和 腊 步 模式 之 间 并 不 是 零 和 关系 ， 但 如 果 在 代码 中 将 两 者 
混用 会 让 事情 复杂 化 。 在 这 两 种 模式 之 间 进 行 切换 困难 重重 ， 并 且 困 难 
程度 随 情况 而 异 。 对 于 一 个 仅 对 外 提供 同步 操作 的 网 络 库 来 说 ， 为 同步 
操作 编写 异步 封装 很 难保 证 代码 安全 ， 反 之 亦 然 。 


特别 需要 注意 ， 通 过 Task<TResult>.Result 属 性 和 Task.wait() 方 法 以 同 
步 方式 从 异步 操作 获取 结果 是 有 风险 的 ， 容 易 导 致死 锁 。 多 数 情 况 下 ， 
异步 操作 需要 在 阻塞 线程 中 执行 续 延 ， 以 等 待 操作 完成 。 


相关 话题 ， 可 以 阅读 Stephen Toub 的 技术 博文 “Should I expose 
synchronous wrappers for asynchronous methods?” 和 “Should I expose 
asynchronous wrappers for synchronous methods?”， 两 篇 文章 对 此 做 了 详 
细 而 深入 的 论述 。《〈 剧 透 : 两 种 情况 的 管 案 都 是 “ 否 ”。) 当然 ， 所 有 规 
则 强 有 例外 ， 但 强烈 建议 读者 在 彻底 搞 懂 之 后 ， 再 考虑 违反 规则 。 


5.10.4 根据 需要 提供 取消 机 制 


取消 机 制 在 同步 模式 中 并 没有 对 等 机 制 ， 在 同步 代码 中 一 般 需要 等 到 方 
法 返回 之 后 才能 执行 后 续 代 码 。 异 步 模式 中 的 取消 机 制 功能 十 分 强大 ， 
但 它 依 赖 整个 调用 栈 的 协作 。 对 于 那些 不 接受 取消 令 牌 的 方法 ， 其 实用 
性 会 大 大 降低 。 虽 然 可 以 编写 一 些 复杂 的 代码 给 async 方 法 添加 取消 状 
态 ， 来 取代 不 文 持 取消 的 task 的 结果 ， 但 这 并 不 是 理想 的 解决 方案 。 我 
们 真正 想 要 的 是 ， 能 够 终止 正在 执行 的 任务 ， 并 且 在 操作 完成 后 ， 无 须 
关心 资源 的 回收 和 释放 。 


还 好 大 部 分 奔 层 异步 API 可 以 接收 取消 令 牌 作为 参数 。 我 们 需要 做 的 残 
古 采 用 同样 的 模式 ， 把 从 参数 获取 的 取消 令 脾 作为 所 有 调用 async 方 法 
的 实 参 进行 传递 。 即 使 当前 并 不 需要 文 持 取消 操作 ， 但 最 好 一 开始 束 文 
持 取 消 ， 不 然 将 来 再 添加 支持 会 很 厅 烦 。 
































再 次 提醒 : 对 于 如 何 解决 异步 操作 不 文 持 取消 的 问题 ， 可 参考 Stephen 


Toub 的 博文 “How do I cancel non-cancelable async operations?”。 
5.10.5 ”测试 异步 模式 


异步 模式 的 测试 可 能 极其 困难 ， 尤 其 是 在 需要 测试 异步 模式 本 号 时 。 
《比如 测试 “如 果 取 消 本 方法 第 2 个 和 第 3 个 异步 调用 之 间 的 操作 会 发 生 
什么 ”会 涉及 复杂 烦琐 的 工作 。) 


里 然 并 不 是 不 可 完成 的 任务 ， 但 奉 要 做 到 全 面 的 测试 履 盖 ， 必 将 是 一 场 
攻坚 战 。 在 编写 本 书 第 3 版 时 ， 我 还 畅想 到 2019 年 会 有 健全 的 框架 问 
世 ， 能 简化 异步 测试 的 工作 ， 可 惜 未 能 如 愿 。 


不 过 目前 大 部 分 单元 测试 框架 支持 异步 测试 。 由 于 同步 代码 和 异步 代码 
的 泥 合 编写 困难 重重 ， 因 此 这 一 支持 对 于 测试 异步 方法 至 关 重要 。 编 写 
异步 测试 方法 很 简单 ， 只 需要 async 修 饰 符 和 Task 的 返回 类 型 即 可 。 








[Test] 
public async Task FooAsync() 
{ 
<------ 测试 FooAsync 产 品 代 码 的 测试 代码 
} 


测试 框架 通常 会 提供 Assert .ThrowsAsync 方 法 ， 来 测试 某 个 异步 方法 返 
回 faulted task 的 情况 。 


在 测试 异步 代码 时 ， 经 党 需要 创建 一 个 已 经 完成 的 task， 该 task 有 正常 
或 者 faulted 的 返回 结果 ， 此 时 Task.FromResult、Task.FromException 和 
Task.FromCcanceled 方 法 就 派 上 用 场 了 。 


如 果 想 进一步 提升 灵活 性 ， 也 可 以 使 

用 TaskcompletionSource<TResu1lLt>。 框架 中 很 多 异步 基础 架构 使 用 该 方 
法 。 通 过 它 能 够 创建 菜 个 正在 执行 的 task， 并 为 其 预先 设置 返回 结果 
(也 可 以 是 异常 或 者 取消 ) ， 然 后 到 达 系 个 市 点 时 task 完 成 。 当 我 们 想 
从 某 个 mock 依 赖 中 得 到 返回 的 task， 又 需要 在 之 后 的 测试 中 让 task 完 成 
时 ， 该 方法 可 发 挥 奇效 。 


关于 TaskCompletionSource<TResult>， 还 需要 知道 ， 在 设 定 返 回 结果 
时 ，task 对 应 的 续 延 可 以 在 同一 线程 中 同步 执行 。 续 延 如 何 执行 的 具体 














细节 ， 则 依赖 线程 的 不 同情 况 以 及 相关 同步 上 下 文 。 了 解 这 一 点 之 后 ， 
读者 就 不 用 重复 我 曾经 走 过 的 弯路 了 。 


以 上 就 是 我 编写 异步 代码 几 年 来 学 习 和 总 络 的 一 些 不 完全 经 验 ， 而 无 意 
偏离 本 书 的 宗旨 《本 书 是 关于 C# 语 言 的 ， 而 不 是 异步 ) 。 前 面 从 开 及 人 
员 的 角度 探讨 了 async/await 特 性 的 功能 。 虽 然 透 过 可 等 竺 模式 得 以 初 颖 
异步 背后 的 实现 原理 ， 但 依然 未 能 涵 凋 所 有 细节 。 


第 6 章 将 介绍 异步 的 实现 原理 ， 如 采访 者 之 前 没有 使 用 过 async/await 特 
性 ， 强 烈 建议 动手 实践 。 这 些 实现 原理 的 细节 很 重要 ， 但 颇 为 复 森 ， 即 
便 经 验 丰 宇 的 开发 人 员 也 不 敢 小 鹏 ， 如 果 没 有 相关 使 用 经 验 ， 学 习 将 步 
履 维 艰 。 如 有 果 既 没有 实践 经 验 ， 同 时 目前 也 不 打算 花 时 间 实 践 的 话 ， 建 
议 先 跳 过 第 6 章 。 第 6 章 只 介绍 卉 步 的 实现 细节 ， 即 便 跳 过 也 不 会 耽误 对 
其 他 内 容 的 学 习 。 











5.11 小结 


。 异步 模式 的 核心 思想 : 先 发 起 一 个 操作 ， 然 后 在 不 阻塞 线程 的 前 提 
下 ， 等 到 操作 完成 之 后 再 恢复 先前 的 执行 。 

。 采用 async/await， 我 们 能 以 熟悉 的 方式 编写 异步 代码 。 

。 async/await 人 负责 处 理 同步 上 下 文 ， 这 样 UI 代 码 能 够 启动 一 个 异步 操 

作 ， 等 到 操作 完成 后 继续 回 到 UI 线程 执行 代码 。 

成 功 的 返回 结果 和 异常 都 会 由 异步 操作 生成 。 

await 运 算 符 的 使 用 有 一 些 限 制 ，C# 6 取消 了 C# 5 中 的 部 分 限制 。 

编译 器 根据 可 等 得 模式 来 决定 什么 类 型 可 以 被 await。 

C# 7 人 允许 创建 自 定义 task 类 型 ， 但 绝 大 部 分 情况 下 只 需要 使 

用 ValueTask<TResult> 类 型 。 


e。 C# 7.1 人 允许 异步 Main 方 法 来 作为 程序 入 口 方法 。 
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第 6 半 措 步 原理 


本 章 内 容 概览 


。 异步 代码 的 结构 ; 

。 如 何 与 框架 builder 类 型 进行 交互 ; 

。 如 何在 async 方 法 中 单 步 执行 ; 

。 执行 上 下 文 如 何 贯 通 await 表 达 式 ; 
e。 如 何 与 自 定 义 task 类 型 进行 交互 。 


2010 年 10 月 28 日 的 那个 夜晚 至 今 依 然 历 历 在 目 。 当 时 Anders Hejlsberg 正 
在 PDC 上 演示 async/await 。 束 在 他 的 演讲 开始 的 前 几 分 钟 ， 海 量 的 相关 
可 下 载 文件 在 网 上 放出 ， 其 中 包括 C# 编 程 规范 变更 大 纲 、C# 5 编译 器 的 
社区 技术 预览 (community technology preview，CTP) ， 以 及 Anders 
Hejlsberg 下 在 演示 的 PPT 文 稿 。 我 一 边 观看 Anders 的 实时 演讲 ， 一 边 飞 
快 地 浏览 他 的 活 讲 文稿 ， 同 时 计算 机 上 正安 闭 着 预览 版 的 编译 器 。 当 
Anders Hejlsberg 完 成 演讲 时 ， 我 已 经 可 以 开始 编写 异步 代码 并 进行 一 些 
初步 尝试 了 。 


接 下 来 的 几 周 里 ， 我 都 致力 于 反复 研究 编译 圳 所 生成 的 代码 ， 并 尝试 实 
现 一 个 类 似 于 CTP 所 提供 库 的 简化 版 本 。 当 C# 的 新 版 本 友 布 之 后 ， 我 终 
于 弄 清楚 哪里 改进 了 ， 并 且 对 于 腊 步 机 制 背后 的 原理 人 鳄 发 欣 入。 随 着 对 
该 特性 理解 的 逐步 深入 ， 我 发 现 编译 器 默默 地 葡 我 们 完成 了 很 多 样板 代 
人 码 的 编写 ， 令 我 愈加 心怀 感激 之 情 。 这 个 过 程 就 像 是 用 显微镜 研究 一 末 
美丽 的 花 : 看 得 越 仔细 、 越 深入 ， 越 发 现 它 美不胜收 。 


当然 ， 不 是 所 有 人 的 感受 部 和 我 相同 。 对 于 那些 无 暇 探究 异步 实现 机 理 
的 开发 人 员 ， 他 们 完全 可 以 凭借 第 5 半 所 述 内 容 编写 出 无 误 的 异步 代 
码 。 读 者 完全 可 以 跳 过 本 章 ， 因 为 后 面 的 章节 与 本 草 没 有 任何 依赖 关 
系 。 其 实 读者 很 少 会 在 调试 程序 时 深入 到 本 章 所 探讨 的 层次 ， 不 过 本 章 
的 目标 是 让 大 家 更 好 地 理解 async/await 是 如 何 协调 工作 的 。 学 完 本 章 内 
容 后 ， 再 回头 看 可 等 待 模式 以 及 目 定 义 task 类 型 ， 会 感觉 更 加 得 心 应 
手 。 这 个 过 程 听 起 来 虽然 有 些 不 可 思议 ， 不 过 开发 人 员 确 实 能 够 通过 学 
习 这 些 实现 细节 来 加 深 对 C# 语 言 的 理解 。 


























接 下 来 需要 做 一 个 假定 : C# 编 译 器 可 以 把 使 用 async/await 的 C# 代 码 转 
换 成 不 含有 async/await 的 C# 代 人 码 。 当 然 ， 这 只 是 一 种 粗略 的 近似 ， 因 
为 编译 器 实际 的 工作 层级 是 可 以 emit 为 全 的 中 间 表 示 层 。 实 际 

上 async/await 的 某 些 代 码 所 生成 的 下 代码 并 不 能 通过 常规 的 C# 代 码 来 表 
示 ， 好 在 这 些 地 方 也 都 不 难 解 释 。 


调试 构建 和 发 布 构建 存在 区 别 “〈“ 将 来 可 能 亦 然 ) 


在 编写 本 章 时 ， 我 发 现 调 试 构 建 和 发 布 构建 中 的 异步 代码 存在 差 
异 : 在 调试 构建 中 ， 生 成 的 状态 机 是 类 型 ， 而 不 是 结构 体 。〈 这 种 
方式 会 便于 调试 ， 尤 其 是 会 增强 Edit 和 Continue 的 灵活 性 。) 在 我 
编写 本 书 第 3 版 时 ， 这 两 种 构建 方式 还 没有 差异 ， 但 之 后 编译 器 的 
实现 发 生 了 变更 ， 而 且 将 来 有 可 能 再 次 变更 。 很 有 可 能 将 来 使 用 C# 
8 编译 器 对 异步 代码 进行 反 编 译 时 ， 看 到 的 代码 跟 此 时 又 不 同 了 。 


不 过 对 于 这 种 意外 情况 ， 也 不 必 太 过 不 安 。 根 据 定义 ， 实 现 细 市 是 
允许 不 断 变更 的 。 我 们 研究 茶 个 实现 的 意义 也 不 会 因此 而 丧失 。 只 
再 要 意识 到 这 不 同 于 学 习 C# 的 规则 ， 总 会 有 不 期 而 至 的 变化 。 


本 章 展 示 的 生成 代码 都 是 基于 发 布 构建 的 。 两 种 构建 所 生成 代码 的 
主要 差别 在 于 性 能 ， 大 部 分 读者 更 关注 发 布 构建 的 性 能 ， 而 不 是 调 
试 构建 的 性 能 。 


编译 器 生成 的 代码 就 像 一 个 洋 柳 :其 复杂 性 是 层 层 包 右 的 。 我 们 将 从 最 
外 层 的 代码 开始 探讨 ， 然 后 逐步 癌 着 更 复杂 的 内 容 进 及 : await 表 达 式 
以 及 awaiter 与 续 延 之 间 的 交织 缠绵 。 简 单 起 见 ， 这 里 只 探讨 异步 方法 ， 
而 不 涉及 异步 匿名 函数 。 二 者 背后 的 机 制 相同 ， 无 须 袭 述 。 


6.1 生成 代码 的 结构 


第 5 章 提 过 ， 异 步 模 式 的 实现 原理 不管 是 近似 方式 的 代码 还 是 编译 器 
实际 生成 的 代码 ) 是 基于 状态 机 的 。 编 译 器 会 生成 一 个 私有 的 能 套 结 构 
体 来 代表 寞 步 方法 ， 而 且 它 必须 包含 一 个 与 所 声明 方法 同名 的 方法 。 这 
个 同名 方法 称 为 桩 方法 。 这 个 方法 本 里 没什么 特别 之 处 ， 不 过 它 是 之 后 
一 切 的 起 始 方法 。 


说 明 ”后 文 会 经 常 提 到 一 个 概念 : 状态 机 和 暂停。 暂停 所 对 应 的 时 间 


























点 是 : 当 async 方 法 执行 到 某 个 await 表 达 式 ， 被 await 的 操作 疝 未 完 
成 。 第 5 章 讲 过 ， 当 状态 机 暂停 后 会 安排 一 个 续 延 ， 然 后 async 方 法 
返回 。 等 到 操作 完成 后 ， 续 延 负 责 执行 async 方 法 中 的 其 余 代码 。 

与 之 类 似 ， 需 要 讨论 async 方 法 中 的 步 进 : 在 方法 暂停 期 间 所 执行 
的 代码 。 以 上 这 些 并 非 官方 术语 ， 只 是 有 助 于 后 文 的 讲解 。 


状态 机 负责 追踪 async 方 法 当前 的 执行 进度 。 从 导 辑 上 讲 ， 可 以 分 为 以 
下 4 种 状态 〈 按 照 正常 的 执行 顺序 排列 ) : 


© 未 启动 ; 

。 正在 执行 ; 

© 暂停 ; 

。 完成 (成 功 或 faulted) 。 


其 中 只 有 和 暂停 类 的 状态 与 async 方 法 的 结构 有 关 。async 方 法 中 的 每 

个 await 表 达 式 是 单独 的 状态 ， 每 次 返回 后 都 会 触及 后 续 代 码 的 执行 。 
在 状态 机 执行 期 间 ， 它 不 需要 退 踪 当前 执行 代码 。 这 些 代码 由 CPU 的 指 
令 指针 来 退 踪 其 执行 位 置 ， 这 一 点 和 同步 代码 相同 。 只 有 当 状 态 机 需要 
进入 暂停 时 ， 才 需要 记录 状态 。 记 录 状 态 旨 在 从 当前 执行 位 置 恢复 执 
行 。 图 6-1 展 示 了 不 同 状 态 之 间 的 转换 关系 。 














图 6-1 状态 之 间 的 转换 
下 面 通过 一 段 代码 来 增强 认识 。 代 码 清单 6-1 是 一 个 简单 的 async 方 法 





〈 不 是 最 简单 的 async 方 法 ， 但 可 以 同时 展示 多 个 要 点 ) 。 
代码 清单 6-1 简单 入 门 async 方 法 
static async Task PrintAndwait(TimeSpan delay) 


Console.WriteLine("Before first delay"); 
await Task.Delay(delay); 
Console.writeLine("Between delays"); 
await Task.Delay(delay); 
Console.WriteLine("After Second delay"); 


} 
这 里 需要 关注 以 下 几 点 : 


。 async 方 法 包含 一 个 形 参 ， 之 后 在 状态 机 中 会 用 到 该 形 参 ; 

。 async 方 法 包含 了 两 个 await 表 达 式 ; 

。 async 方 法 返回 Task 类 型 的 结果 ， 因 此 在 最 后 一 行 打印 结束 之 后 需要 
返回 一 个 task， 不 过 这 里 并 不 需要 一 个 特定 的 返回 结果 。 


这 个 例子 直 白 易 懂 ， 因 为 其 中 没有 包含 循环 或 者 try/catch/finally 这 些 
复杂 的 结构 。 其 中 的 控制 流 很 简单 〈await 的 部 分 除外 ) 。 下 面 看 看 编译 
器 生成 的 代码 。 
自行 尝试 
我 通常 使 用 ildasm 搭 配 Redgate Relfector 处 理 这 种 问题 ， 并 且 把 优化 
级 别 设置 到 C# 1， 这 样 做 可 以 防止 反 编译 器 对 async 方 法 进行 重组 。 
无 论 读者 使 用 的 是 哪 款 反 编译 工具 ， 都 建议 检查 生成 的 卫 代码。 我 
曾 遇 到 有 的 反 编译 器 在 处 理 await 表 达 式 时 出 现 bug 的 情况 ， 通 常 这 
些 bug 都 与 执行 顺序 有 关 。 


对 生成 代码 进行 反 编译 研究 不 是 强制 要 求 。 如 果 读 者 哪 天 对 编译 器 
所 生成 的 代码 感到 好 奇 ， 从 本 书 中 也 寻找 不 到 答案 ， 建 议和 尝试 探 
索 。 不 过 请 不 要 瑟 记 调试 构建 和 发 布 构建 的 送别 ， 也 不 要 被 编译 器 
所 生成 的 各 种 名 称 吓 到 《不 太 便 于 阅读 ) 。 


利用 这 些 工 具 ， 可 以 把 代码 清单 6-1 反 编译 为 代码 清单 6-2 所 示 结 果 。 很 
多 C# 编 译 强生 成 的 名 称 不 是 有 效 的 C# 名 称 ， 因 此 我 对 这 部 分 名 称 做 了 
倒 换 ， 以 保证 代码 可 运行 。 我 也 会 对 茶 些 标识 符 名 称 进 行 重合 名， 以便 





于 阅读 。 另 外 ， 我 还 调整 了 状态 机 的 case 和 标签 的 顺序 。 这 种 调整 对 代 
码 逻 辑 完全 没有 影响 ， 但 能 够 明显 增强 可 读 性 。 有 的 地 方 即便 只 a 
case， 我 也 使 用 了 switch 语 句 〈 编 译 器 则 可 能 会 采用 if/else 乡 7 ， 
为 switch 语 句 能 够 代表 多 个 跳 转 位 置 这 样 更 普遍 的 情况 。 不 过 0 
要 为 简单 的 情况 做 尽 可 能 简单 的 优化 。 


代码 清单 6-2 ”代码 清单 6-1 生 成 后 的 代码 (| 除 MoveNext 外 ) 


# 桩 方法 
[AsyncStateMachine(typeof (PrintAndwaitStateMachine))] 
[DebuggerStepThrough] 

private static unsafe Task PrintAndwait(TimeSpan delay) 


{ 





var machine = new PrintAndwaitStateMachine (本 行 及 以 下 5 行 ) 初始 人 
{ 

delay = delay, 

builder = AsyncTaskMethodBuilder.Create(), 











state = -1 
}; 
machine.builder.Start(ref machine); <------ 运行 状态 机 ， 直 到 需要 
return machine.builder.Task; <------ 返回 代表 异步 操作 的 task 
} 
# 状态 机 的 私有 结构 体 
[CompilerGenerated] 


private struct PrintAndwaitStateMachine :; IAsyncStateMachine 























public int state; <------ 状态 机 的 状态 (需要 恢 复 的 位 置 ) 

public AsyncTaskMethodBuilder builder; <------ 异步 基础 架构 类 型 
private TaskAwaiter awaiter; <------ 当 恢 复 执行 时 用 于 获取 结果 的 awt 
public TimeSpan delay; <------ 原始 方法 参数 

void IAsyncStateMachine.MoveNext() (本 行 及 以 下 2 行 ) 状态 机 主要 的 工 1 
{ 

} 

[DebuggerHidden] 


void IAsyncStateMachine,.SetStateMachine( 
IAsyncStateMachine stateMachine) 


this,.builder .SetStateMachine(stateMachine); <------ 连接 bu 





} 
代码 清单 6-2 看 上 去 比较 复 森 。 在 此 提醒 ，MoveNext 方 法 才 是 这 段 代 码 的 





重头 戏 ， 而 我 已 经 暂时 去 挥 这 部 分 实现 逻辑 了 。 代 码 清单 6-2 的 作用 
是 ， 为 学 习 MoveNext 实 现 做 好 思想 准备 ， 以 及 初步 认识 代码 结构 。 下 面 
逐 段 分 析 以 上 代码 ， 首 先是 桩 方法 。 


6.1.1 桩 方法 : 准备 和 开始 第 一 步 


代码 清单 6-2 中 的 桩 方法 除了 AsyncTaskMethodBuilder， 其 余 都 比较 简 
单 。 AsyncTaskMethodBuilder 是 一 个 值 类 型 ， 它 是 通用 异步 基础 架构 的 
一 部 分 。 稍 后 会 介绍 builder 和 状态 机 如 何 交 互 。 


[AsyncStateMachine(typeof (PrintAndwaitStateMachine))] 
[DebuggerStepThrough] 
private static unsafe Task PrintAndwait(TimeSpan delay) 


var machine = new PrintAndwaitStateMachine 


delay = delay, 
builder = AsyncTaskMethodBuilder.Create(), 
state = -1 

}; 

machine.builder.Start(ref machine); 

return machine.builder.Tastk; 


} 


该 方法 中 所 应 用 的 attribute 主 要 用 于 辅助 ， 对 于 正常 的 执行 流程 没有 影 
啊 ， 而 且 无 助 于 理解 生成 异步 代码 的 原理 。 状 态 机 都 是 在 桩 方法 中 创建 
的 ， 主 要 需要 以 下 3 点 信息 : 


。 形 参 〈 在 本 例 中 是 delay) ， 每 个 形 参 在 状态 机 中 都 是 独立 的 字 
段 ; 

。 builder， 这 个 对 象 会 随 着 async 方 法 返回 类 型 的 不 同 而 异 ; 

。 初始 状态 ， 永 远 是 -1。 


说 明 AsyncTaskMethodBuilder 这 个 名 称 可 能 让 人 联想 到 反射 ， 但 
它 并 没有 在 下 中 创建 方法 。 生 成 代码 可 以 使 用 builder 提 供 的 功能 来 
生成 成 功 信息 或 失败 信息 、 处 理 await 等 。 读 者 完全 可 以 把 它 当 

作 “helper" 来 理解 。 


在 创建 好 状态 机 之 后 ， 桩 方法 会 请 求 状态 机 的 builder 来 局 动 它 ， 并 将 状 
态 机 上 自身 以 引用 的 方式 传 给 方法 。 后 文 会 经 常 使 用 引用 传递 ， 通 过 引用 




















传递 可 以 保证 效率 和 对 象 一 致 性 。 状 态 机 和 AsyncTaskMethodBuilder 都 
是 不 可 变 的 值 类 型 。 通 过 引用 传递 nachine 给 start 方 法 可 以 避免 状态 的 
复制 ， 这 种 方式 更 高 效 ， 并 且 可 以 确保 在 start 方 法 中 对 状态 的 任何 修 
改 都 可 以 在 start 方 法 返回 之 后 呈现 给 调用 方 。 状 态 机 中 builder 的 状态 
在 start 中 会 发 生变 化 。 这 就 是 在 start 调 用 和 之 后 的 Task 属 性 都 要 使 

用 machine.builder 的 原因 。 假 设 把 machine.builder 赋 值 给 一 个 局 部 变 
里 .: 














var builder = machine.builder; (本 行 及 以 下 2 行 ) 不 可 行 的 重 构 方式 
builder.Start(ref machine ) ， 
return builder ,TaSsk 


如 果 这 样 写 ，builder.start() 方 法 内 部 发 生 的 状态 变化 不 会 反映 

在 machine.builder〈 反 之 亦 然 ) ， 因 为 它 只 是 builder 的 一 份 副本 。 这 也 
是 machine.builder 是 一 个 字段 而 不 是 属性 的 原因 。 不 应 在 状态 机 中 操作 
builder 的 副本 ， 而 应 当 直 接 操作 状态 机 本 喘 的 那些 值 。 这 种 程度 的 细节 
处 理 ， 本 不 是 开发 人 员 应 当 顾及 的 ， 因 此 不 推荐 编写 可 变 值 类 型 和 公共 
字段 。 (第 11 章 将 介绍 这 样 设计 的 妙 处 和 背后 的 精心 考量 。) 


状态 机 开始 之 后 并 不 会 创建 任何 新 线程 。 它 只 是 执行 状态 机 中 的 
MoveNext() 方 法 ， 直 到 状态 机 await 另 一 个 异步 操作 或 者 状态 机 完成 为 
止 。 换 言 之 ， 它 按照 步 进 的 方式 执行 。 不 管 是 哪 种 情况 ，MoveNext () 方 
法 都 会 返回 ， 此 时 machine.builder.Start() 方 法 也 会 返回 ， 这 样 就 可 以 
把 task 作 为 整个 异步 方法 的 结果 返回 给 调用 方 。builder 负 责 创 建 task 并 且 
确保 它 在 异步 方法 的 整个 执行 期 间 能 够 正确 切换 状态 。 


以 上 就 是 桩 方法 的 内 容 。 下 面 看 看 状态 机 本 和 号 。 
6.1.2 ”状态 机 的 结构 


这 里 还 是 省 略 了 状态 机 中 的 主要 代码 〈MoveNext() 方 法 中 的 代码 ) ， 该 
类 型 的 结构 如 下 : 


[CompilerGenerated] 
private struct PrintAndwaitStateMachine :; IAsyncStateMachine 





public int State 

public AsyncTaskMethodBuilder builder; 
private TaskAwaiter awaiter; 

public TimeSpan delay; 


void IAsyncStateMachine.MoveNext() 


[DebuggerHidden] 
void IAsyncStateMachine,.SetStateMachine( 
IAsyncStateMachine stateMachine) 


this.builder.SetStateMachine(stateMachine); 


上 
同样 ， 这 个 方法 中 的 attribute 并 不 重要 。 关 于 该 类 型 ， 有 如 下 几 个 要 
所 。 








。 它 实 现 了 IAsyncstateMachine 接 口 ， 该 接口 用 于 异步 基础 架构 ， 它 
仅 包含 两 个 方法 。 

。 类 型 中 的 字段 存储 着 状态 机 在 步 进 时 所 需要 的 信息 。 

e。 MoveNext() 方 法 在 状态 机 启动 后 或 暂停 恢复 后 被 调用 。 

。 SetStateMachine() 方 法 的 实现 总 是 保持 不 变 〈 在 发 布 构建 中 ) 。 


其 实 之 前 接触 过 IAsyncSstateMachine 接 口 的 实现 ， 只 不 过 它 被 隐藏 

了 了 : AsyncTaskMethodBuilder.Start() 是 一 个 泛 型 方法 ， 它 具 有 一 个 类 
型 约束 ， 类 型 形 参 必须 实现 IAsyncstateMachine 接 口 。 在 完成 一 些 内 部 
事务 后 ， start() 调 用 MoveNext() 方 法 来 让 状态 机 执行 async 方 法 的 第 一 


九 。 
其 中 涉及 的 字段 大 致 可 分 为 以 下 5 类 : 
当前 状态 (例如 未 启动 、 和 暂停 等 香菜 个 await 表 达 式 等 ); 

















。 方法 builder， 用 于 和 异步 基础 架构 交互 ， 并 且 提 供 返 回 的 Task:; 
e awaiter; 

。 形 参 和 局 部 变量 ; 

。 |I 临 时 栈 变量 。 





ee 状态 就 是 一 个 整 型 值 ， 有 以 下 几 种 可 能 





。 -1， 尚 未 局 动 或 正在 执行 (具体 是 哪个 没有 影响 〉; 





e。 -2， 执 行 完成 《成 功 或 faulted) ; 
。 其 他 值 ， 正 在 某 个 await 表 达 式 处 暂停 。 


如 前 所 述 ，builder 的 类 型 取决 于 async 方 法 的 返回 类 型 。 在 C#7 以 前 ， 
builder 类 型 总 是 AsyncVoidMethodBuilder、AsyncTaskMethodBuilder 或 
者 AsyncTaskMethodBuilder<T>。 当 C#73 引 入 自 定义 task 类 型 后 ，builder 
类 型 根据 定义 task 类 型 时 的 AsyncTaskMethodBuilderAttribute 指 定 。 


视 async 方 法 体 的 不 同 ， 其 他 字段 会 稍 复杂 一 些 ， 编 译 器 会 尽 可 能 定义 
最 少 的 字段 。 关 键 在 于 : 只 有 当 状 态 机 在 某 个 时 间 节 点 恢复 时 ， 才 需要 
和 se 
完全 忽略 它们 。 


关于 编译 器 复 用 字段 的 第 1 个 例子 是 awaiter。 一 次 只 能 有 一 个 相关 的 
awaiter， 因 为 任何 特定 状态 机 一 次 都 只 能 await 一 个 值 。 编 译 器 会 为 每 个 
awaiter 创 建 一 个 字段 。 如 果 在 async 方 法 中 await 两 个 Task<int> 值 ，1 
个 Task<string> 和 3 个 非 泛 型 的 Task 值 在 async 方 法 中 ， 那 么 最 终 会 得 到 3 
个 字段 : TaskAwaiter<int>、 TaskAwaiter<string> 和 一 个 非 泛 型 的 
TaskAwaiter。 编 译 器 会 根据 awaiter 的 类 型 为 每 个 await 表 达 式 匹配 合适 
的 字段 。 

说 明 这 里 假定 awaiter 是 由 编译 器 引入 的 。 如 果 上 自行 调 

用 GetAawaiter() 然 后 把 结果 赋值 给 某 个 局 部 变量 ， 那 么 它 会 被 视 为 

普通 的 局 部 变量 。 这 里 讨论 的 awaiter 专 指 await 表 达 式 返回 的 结 

果 。 
下 面 考 虑 局 部 变量 。 这 里 编译 器 没有 复 用 字段 ， 而 是 可 以 把 它们 完全 忽 
略 。 如 果 某 个 局 部 变量 仅 在 两 个 await 表 达 式 之 间 使 用 ， 而 不 是 贯穿 整 
个 await 表 达 式 ， 那么 它 在 MoveNext () 方 法 中 依然 保持 局 部 变量 的 形态 。 


考虑 以 下 async 方 法 : 


public async Task LocalVariableDemoAsync() 


























int x = DateTime.UtcNow.Second; <------ x 在 await 之 前 赋值 

int y = DateTime.,UtcNow.Second; (本 行 及 以 下 1 行 ) y 只 在 await 之 前 使 
Console.writeLinel(y); 

await Task.Delay(); 

Console.wWriteLine(x); <------ x 在 await 之 后 使 用 


编译 器 会 为 x 创 建 一 个 字段 ， 因 为 当 状 态 机 暂 俘 时 ， 需 要 保存 x 的 值 。y 
则 不 同 ， 在 代码 执行 时 它 依 然 可 以 保持 局 部 变量 。 


说 明 ”编译 器 在 尽量 创建 最 少 字 段 这 方面 做 得 很 好 。 但 有 时 你 也 许 
会 发 现 菏 个 编译 右 应 当做 优化 但 并 没有 做 。 例 如 两 个 变量 具有 相同 
的 类 型 并 且 都 贯穿 了 整个 await 表 达 式 〈 因 此 需要 为 它们 创建 字 
段 ，， 但 是 它们 不 会 在 同一 个 作用 域 同时 出 现 。 此 时 编译 器 就 应 该 
可 以 像 处 理 awaiter 那 样 只 创建 一 个 字段 。 在 编写 本 章 时 ， 这 一 优化 
未 能 实现 ， 未 来 会 如 何 ， 让 我 们 拭目以待 。 
此 外 ， 还 有 一 些 临 时 栈 变量 。 当 await 表 达 式 用 作 其 他 表达 式 的 一 部 分 
时 ， 如 果 需 要 记录 某 些 中 间 值 ， 那 么 会 用 到 临时 栈 变量 。 代 码 清 单 6-1 
中 没有 这 类 栈 变 量 ， 所 以 代码 清单 6-2 只 有 4 个 字段 : 状态 、builder、 
awaiter 和 参数。 具体 示例 如 下 : 


public async Task TemporaryStackDemoAsync ( ) 

















{ 

Task<int> task = Task.FromResult(10); 

DateTime now = DateTime.UtcNow; 

int result = now,Second + now.Hours * await task; 
} 


async 方 法 中 依然 需要 遵守 C# 关 于 操作 数 运算 的 规则 。now.second 和 
now.Hours 都 需要 在 await task 之 前 完成 运算 。 当 task 完 成 ， 状 态 机 恢复 之 
后 ， 需 要 进行 数学 运算 ， 因 此 必须 记录 这 两 个 值 。 


说 明 在 本 例 中 ， 我 们 清楚 Task.FromResult 会 返回 一 个 已 完成 的 
task， 但 是 编译 器 并 不 清楚 这 一 点 ， 因 此 它 需 要 生成 一 个 状态 机 ， 
以 便 在 task 没 有 完成 时 可 以 实现 暂停 和 恢复 。 

可 以 把 它 看 作 编 译 器 重 写 了 代码 并 引入 了 局 部 变量 : 


public async Task TemporaryStackDemoAsync ( ) 











Task<int> task = Task.FromResult(10); 
DateTime now = DateTime.UtcNow; 

int tmp1 = now.Second; 

int tmp2 = now.Hours,; 

int result = tmp1 + tmp2 * await task; 





然后 局 部 变量 被 转换 为 字段 。 与 实际 的 局 部 变量 不 同 ， 编 译 器 会 复 用 相 
同类 型 的 临时 栈 变 量 ， 并 且 只 会 按 需 创建 字段 。 


介绍 过 了 状态 机 中 的 所 有 字段 类 型 ， 下 面 看 看 MoveNext () 方 法 ， 不 过 只 
大 致 介 绍 概念 ， 可 作为 学 习 起 步 。 


6.1.3 ”MoveNext() 方 法 (整体 介绍 ) 

这 里 不 会 给 出 代码 清单 6-1 反 编译 之 后 的 MoveNext() 方 法 实现 ， 因 为 该 方 
法 的 代码 实在 太 长 1。 首 先 介 绍 该 方法 的 执行 流程 ， 便 于 之 后 查看 具体 
的 代码 ， 因 此 需要 尽 可 能 地 做 抽象 描述 。 

1 套用 电影 《好 人 窜 容 》 中 的 台词 就 是 : MoveNext 吗 ? 别 想 了 ， 不 好 对 
付 。 








每 次 MoveNext() 被 调用 时 ， 状 态 机 都 会 癌 前 执行 一 步 。 每 次 执行 到 await 
表达 式 时 ， 如 果 被 await 的 值 已 经 完成 则 继续 执行 ， 否 则 状态 机 将 暂 
停 。MoveNext () 会 在 以 下 几 种 情况 下 时 返回 。 


。 状态 机 需要 暂停 等 待 一 个 未 完成 的 值 。 
。 执行 流程 到 达 了 方法 的 末尾 或 者 过 到 一 条 return 语 句 。 
。 在 async 方 法 中 有 异常 抛 出 并 且 寞 常 没 有 被 捕获 。 


注意 ， 在 最 后 一 种 情况 下 ，MoveNext() 方 法 最 终 并 不 会 抛 出 一 个 异常 。 
但 是 和 async 调 用 相关 联 的 task 会 变 为 faulted。 〈5.6.5 节 讨论 过 async 方 法 
处 理 异 常 ， 可 自行 回顾 。) 


图 6-2 是 关于 MoveNext() 方 法 的 总 体 流程 图 。 图 中 并 不 包含 异常 处 理 的 部 
分 ， 因 为 流程 图 中 无 法 表示 try/catch 块 。 到 稍 后 学 习 代 码 的 时 候 ， 就 会 
彻底 弄 懂 这 张 图 了 。 图 6-2 中 也 没有 显示 SetstateMachine 方 法 调用 的 部 
分 ， 因 为 这 张 流程 图 已 经 够 复杂 了 。 














图 6-2 async 方法 流程 图 


关于 MoveNext() 方 法 的 最 后 一 点 : 它 的 返回 类 型 是 void， 而 不 是 task 类 
型 。 只 有 桩 方法 才 返 回 task， 返 回 的 task 是 从 状态 机 builder 中 获取 的 ， 它 
需要 等 到 builder 的 Start() 方 法 调用 MoveNext() 开 始 执 行 第 一 步 之 后 才能 
获取 。 其 他 调用 MoveNext( ) 的 地 方 都 属于 基础 架构 的 一 部 分 ， 用 于 将 状 
态 机 从 暂停 状态 恢复 ， 那 些 地 方 都 不 需要 关联 任何 task。6.2 节 会 给 出 以 
上 过 程 的 完整 代码 ， 但 是 在 此 之 前 还 有 一 些 关 于 setstateMachine 的 补充 
内 容 。 


6.1.4 ”SetstateMachine 方 法 以 及 状态 机 的 装 箱 事 宜 


前 面 展 示 了 setstateMachine 的 实现 代码 ， 非 常 简单 : 





void IAsyncStateMachine.SetStateMachine( 
IAsyncStateMachine stateMachine) 


this.builder.SetStateMachine(stateMachine); 


> 


发 布 构建 中 的 方法 实现 和 以 上 代码 相同 。 在 调试 构建 中 ， 状 态 机 是 一 
个 类 ， 上 述 实现 是 空 的 。) 在 功能 层面 ， 这 个 方法 很 好 解释 ， 但 是 细节 
比较 复杂 。 当 状态 机 开始 执行 第 一 步 时 ， 它 是 桩 方法 中 的 一 个 栈 局 部 变 
量 。 如 果 状 态 机 暂停 ， 它 会 将 自己 闭 箱 〈 到 堆 空 间 ) ， 这 样 等 到 状态 机 
恢复 之 后 可 以 找 回 所 有 信息 。 当 它 装 箱 之 后 ，setstateMachine 方 法 使 用 
装 箱 之 后 的 值 被 调 有 用。 换言之， 在 基础 架构 核心 的 某 处 ， 会 有 代码 块 如 
下 : 


void BoxAndRemember<TStateMachine>(ref TStateMachine stateMachine 
where TStateMachine : IStateMachine 




















IStateMachine boxed = stateMachine; 
boxed.SetStateMachine(boxed); 
} 


实际 代码 更 复杂 ， 但 是 以 上 代码 基本 能 体现 其 核心 本 

质 。SsetstateMachine 之 后 会 确保 AsyncTaskMethodBuilder 具 有 一 个 状态 
机 装 箱 版 本 的 引用 。 这 个 方法 必须 在 装 箱 值 之 上 调用 ， 也 必须 在 装 箱 完 
成 后 调用 ， 因 为 装 箱 完 成 之 后 才能 获取 引用 。 如 果 装 箱 完 成 后 在 未 装 箱 
的 值 上 进行 调用 ， 则 无 法 影响 装 箱 值 。〈 请 牢 

记 ，AsyncTaskMethodBuilder 是 一 个 值 类 型 ) 。 这 一 系列 的 复杂 操作 保 
证 了 当 一 个 续 延 委托 传递 给 awaiter 时 ， 续 延 能 够 在 同一 个 装 箱 实例 上 调 
用 MoveNext () 方 法 。 


结果 就 是 状态 机 如 果 不 需 要 装 箱 ， 那 么 装 箱 完全 不 会 发 生 ， 如 果 需 要 ， 
那么 装 箱 一 定 会 发 生 。 当 装 箱 完成 后 ， 所 有 操作 都 在 装 箱 值 之 上 进行 。 
为 了 确保 效率 ， 中 间 还 会 涉及 很 多 复杂 的 代码 。 

这 部 分 内 容 可 能 是 异步 机 制 中 最 为 怪异 和 神秘 的 。 它 听 起 来 毫 无 意义 ， 
但 是 由 于 装 箱 机 制 的 限制 不 得 不 这 么 做 。 而 为 了 保证 状态 机 在 暂停 时 能 
够 保存 所 有 信息 ， 装 箱 操作 又 是 必需 的 。 


如 果 不 能 完全 理解 这 段 代 码 也 没有 关系 。 日 后 需要 在 较 低 层级 调试 异步 
人 可 以 参阅 本 节 内 容 。 除 此 之 外 ， 这 样 的 代码 没什么 价值 ， 唯 有 
新 奇 。 


以 上 就 是 状态 机 的 组 成 部 分 。 后 面 的 内 容 大 都 着 眼 于 MoveNext() 方 法 ， 




















探 完 它 在 不 同情 况 下 的 不 同 执行 方式 。 先 研究 最 简单 的 情况 ， 然 后 逐步 


提高 难度 。 
6.2 一 个 简单 的 MoveNext() 实 现 


以 代码 清单 6-1 中 的 async 方 法 为 例 。 这 个 方法 之 所 以 简单 ， 不 在 于 它 短 
《当然 也 有 关系 ) ， 而 是 因为 它 不 包含 任何 循环 、try 语 句 或 者 using 语 
i 0 ti 
厅 。 


6.2.1 一 个 完整 的 具体 示例 


下 面 展示 完整 的 方法 。 一 开始 不 一 定 能 看 懂 ， 但 至 少 要 花 几 分 钟 时 间 把 
它 看 完 。 有 了 具体 的 示例 之 后 ， 通 用 的 结构 就 更 容易 理解 了 ， 因 为 可 以 
用 作 参 考 。 以 下 是 代码 清单 6-1 的 内 容 ， 也 是 编译 器 即将 处 理 的 输入 内 
容 : 














static async Task PrintAndwait(TimeSpan delay) 


{ 
Console.WriteLine("Before first delay"); 
await Task.Delay(delay); 
Console.WriteLine("Between delays"); 
await Task.Delay(delay); 
Console.WriteLine("After Second delay"); 
} 


代码 清单 6-3 是 以 上 代码 反 编译 之 后 的 结果 ， 不 过 做 了 些许 改动 以 增强 
可 读 性 ( 易 读 版 〉。 


代码 清单 6-3 ”代码 清单 6-1 中 MoveNext() 的 反 编译 结果 


void IAsyncStateMachine.MoveNext() 
{ 
int num = this.state; 
try 
{ 
TaskAwaiter awaiteril,; 
switch (num) 


default: 
goto MethodStart; 


case 0: 
goto FirstAwaitContinuation; 
case 1: 
goto SecondAwaitContinuation; 
} 
MethodStart : 
Console.writeLine("Before first delay"); 
awaiter1 = Task.Delay(this.delay).GetAwaiter(); 
If (awaiteri1.IsCompleted) 


{ 
goto GetFirstAwaitResult; 


this.state = num = 0; 
this.awaiter = awaiteri1; 
this.builder.AwaitUnsafeOnCompleted(ref awaiter1, ref thi 
return; 
FirstAwaitContinuation: 
awaiter1 = this.awaiter,; 
this.awaiter = default(TaskAwaiter); 
this.state = num = -1; 
GetFirstAwaitResult: 
awaiter1.GetResult( ); 
Console.writeLine("Between delays"); 
TaskAwaiter awaiter2 = Task.Delay(this.delay).GetAwaiter( 
If (awaiter2.IsCompleted) 
{ 
goto GetSecondAwaitResult; 


this.state = num = 1; 
this.awaiter = awaiter2; 
this.builder.AwaitUnsafeOnCompleted(ref awaiter2, ref thi 
return; 
SecondAwaitContinuation: 
awaiter2 = this.awaiter,; 
this.awaiter = default(TaskAwaiter); 
this.state = num = -1; 
GetSecondAwaitResult: 
awaiter2.GetResult( ); 
Console.writeLine("After second delay"); 


catch (Exception exception) 


this.state = -2; 
this.builder.SetException(exception); 
return,; 


} 


this.state = -2; 


this.builder.SetResult(); 


代码 很 长 ， 其 中 包含 了 很 多 goto 语 句 和 代码 标签 。 这 种 代码 在 纯 手写 的 
C# 中 几乎 很 难 见 到 。 这 段 代 码 目前 可 能 比较 难 理解 ， 不 过 从 一 个 具体 的 
例子 开始 ， 之 后 读者 可 以 根据 需要 随时 参阅 。 下 面 把 它 进一步 分 解 为 通 
用 的 结构 ， 然 后 是 针对 await 表 达 式 的 特定 部 分 。 到 本 节 结 束 时 ， 代 码 

人 丑陋 ， 但 相信 读者 会 对 其 中 的 原理 理解 得 更 加 

透彻 。 








6.2.2 ”MoveNext () 方 法 的 通用 结构 


即将 进入 异步 模式 的 第 2 层 。MoveNext () 方 法 是 async 状 态 机 的 核心 ， 它 
的 复杂 性 也 昭示 着 编写 异步 代码 天 然 的 困难 性 。 状 态 机 越 是 复杂 ， 就 越 
应 该 庆幸 这 些 工 作 都 是 由 编译 器 而 不 是 我 们 自己 完成 的 。 


说 明 方便 起 见 ， 接 下 来 会 引入 更 多 术语 。 在 await 表 达 式 中 ， 被 
await 的 值 可 能 已 经 完成 或 者 尚未 完成 。 如 果 在 await 时 已 经 完成 ， 
那么 状态 机 将 继 6 本 执行 。 本 书 称 其 为 “快速 路 径 ”， 如 果 尚 未 完成 ， 
那么 状态 机 会 安排 一 个 续 延 并 暂停 。 本 书 称 其 为 “ 慢 速 路 径 ”。 


温 世 提示: MoveNext() 廊 法 会 在 async 访 法 第 一 次 调用 时 做 调 起 ， 然后 每 
次 恢复 时 都 会 执行 一 次 《如 果 每 个 await 表 达 式 都 进入 快速 路 径 ， 那 
么 MoveNext() 只 会 被 调用 一 次 ) 。 该 方法 负 贡 以 下 事务 : 


e (无 论 是 在 原 异步 代码 的 起 始 位 置 或 者 中 间 
六 首 六 

。 当 需 要 暂停 时 ， 保 存 状态 。 包 括 局 部 变量 和 代码 中 的 位 置 。 

。 当 需 要 暂停 时 安排 一 个 续 延 。 

。 从 awaiter 获 得 返回 值 。 














通过 builder 生 成 异常 〈 不 是 让 MoveNext() 自 己 抛 出 异常 ) 
通过 builder 生 成 返回 值 或 者 完成 方法 。 








有 了 这 些 背 景 知识 ， 下 面 看 看 关于 MoveNext() 方 法 结构 的 伪 代 码 。 稍 后 
2 和 到 该 方法 的 结构 会 变 得 更 加 复 
二 。o 


代码 清单 6-4 ”MoveNext() 方 法 的 伪 代 码 


void IAsyncStateMachine.MoveNext() 











{ 
try 
Switch (this.state) 
{ 
default: goto MethodStart ; 
case 0: goto LabeloA; 
case 1: goto Labeli1A; 
case 2: goto Label2A; 
<------ case 的 数量 与 await 表 达 式 数量 相等 
} 
MethodStart : 
<------ 第 一 个 await 表 达 式 之 前 的 代码 
<------ 设置 第 一 个 awaiter 
LabelOA: 
< 从 续 延 中 恢复 执行 的 代码 
Label0B: 
ee 快速 路 径 和 慢 速 路 径 汇 合 之 处 
es 剩余 代码 ， 包 括 更 多 标签 以 及 awaiter 等 











catch (Exception e) (本 行 及 以 下 5 行 ) 通过 builder 填 充 所 有 异常 信息 
{ 





this.state = -2; 
builder.SetException(e); 
return; 








} 
this.state = -2; (本 行 及 以 下 1 行 ) 通过 builder 填 充 方 法 完成 的 信息 
builder.SetResult(); 





| 


其 中 巨大 的 try/catch 块 包含 了 原始 async 方 法 的 所 有 代码 。 如 果 try 块 中 
有 异常 抛 出 ， 不 论 它 以 何 种 方式 抛 出 (await 一 个 faulted 的 操作 、 调 用 一 
个 抛 出 异常 的 同步 方法 或 直接 抛 出 异常 ，， 措 和 常 都 会 被 捕获 并 且 填 元 给 
builder。 只 有 特殊 的 异常 

(ThreadAbortException.、 StackoverflowException 这 些 ) 才 会 导致 
MoveNext() 以 抛 出 异常 的 方式 终结 。 





在 try/catch 块 中 ，MoveNext() 方 法 总 是 以 一 条 switch 语 句 开 始 ， 用 于 根 
据 状 态 跳 转 到 方法 中 的 正确 位 置 。 如 果 state 为 非 负 值 ， 这 意味 痢 是 从 一 
个 await 表 达 式 之 后 恢复 的 。 和 否则 会 被 视 为 MoveNext() 方 法 的 第 一 次 执 
人 


其 他 状态 如 何 








6.1 市 列 出 了 所 有 可 能 的 状态 : 未 局 动 、 正 在 执行 、 和 暂停 和 完成 。 
(其 中 每 个 await 表 达 式 对 应 一 个 暂停 状态 。) 为 什么 状态 机 要 以 相 
同 的 方式 处 理 未 局 动 和 完成 状态 呢 ? 


答案 是 : MoveNext() 永 远 不 能 在 正在 执行 或 者 完成 状态 下 被 调用 。 
可 以 通过 编写 残缺 的 awaiter 实 现 或 者 使 用 反射 来 强制 这 种 行为 ;但 
是 在 正常 的 操作 下 ，MoveNext() 只 有 在 状态 机 启动 或 者 恢复 的 情况 
下 才 会 被 调用 。 其 至 对 于 未 启动 和 正在 执行 这 两 个 状态 都 没有 单独 
的 状态 码 : 它们 的 状态 码 都 是 -1。 完 成 状态 的 状态 码 为 -2， 不 过 状 
态 机 从 不 会 检查 该 状态 码 。 
有 一 个 难点 需要 注意 : 状态 机 中 的 return 语 句 和 原 async 代 码 中 的 return 
语句 有 所 区 别 。 在 状态 机 中 ， 妆 状态 机 为 awaiter 安 排 完 续 延 暂停 后 ， 会 
调用 return 语 句 。 而 原 代码 中 的 return 语 句 最 终 都 会 成 为 状态 机 末尾 的 
语句 ， 位 于 try/catch 块 外 ， 这 里 会 将 方法 完成 (method completion ) 填 
充 给 builder。 


对 比 代 码 清 单 6-3 和 代码 清单 6-4， 可 以 看 到 具体 示例 和 通用 模式 之 间 的 
对 应 关系 。 至 此 ， 已 经 通过 一 个 简单 的 async 方 法 解释 了 关于 生成 代码 
的 几乎 所 有 问题 ， 还 有 await 表 达 式 需要 讨论 。 

6.2.3 ” 详 探 await 表 达 式 


思考 一 下 ， 在 执行 一 个 async 方 法 时 ， 每 次 执行 到 await 表 达 式 都 发 生 了 
什么 。 假 设 此 时 已 经 完成 了 操作 数 的 运算 来 获取 某 个 可 等 待 值 。 


(1) 通过 调用 GetAwaiter() 来 获取 awaiter， 并 将 其 保存 到 栈 上 。 


(2) 检查 awaiter 是 否 已 经 完成 。 如 果 完 成 ， 则 可 以 直接 跳 转 到 结果 获取 
(第 9 步 ) 。 这 是 快速 路 径 。 


(3) 如 果 是 慢 速 路 径 ， 通 过 状态 字段 来 记录 当前 执行 位 置 。 
(4) 使 用 一 个 字段 记录 awaiter。 


(5) 使 用 awaiter 来 安排 一 个 续 延 ， 保 证 当 续 延 执行 时 ， 能 够 回 到 正确 的 
状态 “根据 需要 执行 装 箱 操作 〉。 





























(6) 从 MoveNext() 方 法 返回 到 原始 调用 方 《 如 果 是 第 一 次 暂停 ) ， 或 者 
返回 到 续 延 安排 者 中 。 


(7) 当 续 延 调 起 时 ， 把 状态 设 为 正在 执行 〈-1) 。 

(8) 把 awaiter 从 字段 中 复制 到 栈 中 ， 清 理 字 段 〈 帮 助 回收 垃圾 ) 。 

(9) 从 awaiter 从 获取 结果 ， 该 结果 位 于 栈 上 。 这 一 过 程 与 快速 路 径 或 慢 
速 路 径 无 天。 即便 没有 结果 值 ， 也 需要 调用 GetResult()， 以 便 在 必要 
时 awaiter 可 以 填充 错误 信息 。 

(10) 执 行 剩 余 原始 代码 《可 以 使 用 异步 操作 所 返回 的 值 ) 。 

恨 据 二 述 阔 骤 再 来 看 看 代码 清 单 6-3 中 和 第 一 个 await 表 达 式 相关 的 部 
/ 


志 








代码 清单 6-5 ”代码 清单 6-3 中 有 关 await 表 达 式 的 部 分 


awaiter1 = Task.Delay(this.delay).GetAwaiter(); 
if (awaiteri1.IsCompleted) 


{ 
goto GetFirstAwaitResult; 


this.state = num = 0; 
this.awaiter = awaiteril; 
this.builder.AwaitUnsafeOnCompleted(ref awaiter1, ref this); 
return， 
FirstAwaitContinuation: 

awaiter1 = this.awaiter,; 

this.awaiter = default(TaskAwaiter); 

this.state = num = -1; 
GetFirstAwaitResult: 

awaiter1.GetResult( ); 


室 无 疑问 ， 这 段 代 码 将 严格 按照 上 述 流程 执 行 2。 其 中 两 个 代码 标签 表 
示 着 两 次 跳 转 的 位 置 ， 取 决 于 执行 路 径 : 


2 如 条 先 给 出 了 执行 步骤 的 列表 ， 再 给 出 一 个 不 按照 步 又 执行 的 示例 ， 
反倒 奇怪 。 


。 在 快速 路 径 中 ， 我 们 会 跳 过 慢 速 路 径 的 代码 ; 
。 在 慢 速 路 径 中 ， 当 续 延 被 调 起 时 会 跳 回 到 代码 中 间 《 这 惑 是 switch 


语句 要 放 在 方法 的 起 始 位 置 的 原因 ) 。 


builder .AwaitUnsafeOnCompleted(ref awaiter1，ref this) 调 用 是 装 箱 
操作 的 一 部 分 ， 它 有 一 个 回调 方法 setstateMachine (如 葫 必需， 但 是 每 
个 状态 机 只 会 发 生 一 次 ) ， 然 后 安排 续 延 。 在 有 些 情况 下 ， 会 调 

用 Awaitoncompleted 而 不 是 AwaitunsafeonCcompleted。 这 两 种 方式 的 差 
别 在 于 执行 上 下 文 的 处 理 方式 不 同 ，6.5 节 会 继续 探讨 。 


还 有 没 说 明 其 中 num 局 部 变量 的 使 用 。 它 的 赋值 操作 和 state 字 上 段 的 赋值 
总 是 同时 发 生 ， 但 是 读 取 时 总 是 读 取 局 部 变量 ( 它 的 初始 值 是 从 字段 复 
制 而 来 的 ， 但 是 这 是 字段 值 唯一 被 读 取 的 时 候 ) ， 我 认为 这 完全 是 出 于 
OE 的 。 对 于 num 变 量 的 读 取 操 作 ， 都 可 以 视 为 对 this.state 的 读 











代码 清单 6-5 中 15 行 代码 ， 全 都 是 为 了 完成 下 面 这 一 句 原始 代码 : 
await Task.Delay(delay); 


好 在 除了 这 种 学 习 目 的 ， 几 乎 很 少 需要 得 看 这 类 代码 ; 但 即便 很 小 规模 
的 async 代 码 ， 也 会 导致 编译 后 生成 大 量 代码 ， 即 便 使 

用 valueTask<TResult> 类 型 也 无 法 避免 。 不 过 大 多 数 时 候 这 种 小 的 代价 
还 是 值得 的 ， 因 为 async/await 带 来 的 好 处 更 多 。 


以 上 是 简单 控制 流下 的 简单 案例 。 基 于 这 些 背 景 知识 ， 下 面 研究 一 些 复 
杂 的 案例 。 

















6.3 ”控制 流 如 何 影响 MoveNext () 


前 面 给 出 的 示例 ， 都 只 是 大 干 方法 调用 ， 复 杂 性 主要 来 目 await 运 算 
符 。 如 果 把 平时 第 用 的 那些 控制 流 都 加 进来 ， 情 况 就 会 变 得 更 复杂 了 。 


下 面 介 绍 两 种 控制 流 : 循环 和 try/finally 语 句 。 这 两 种 情况 无 法 覆盖 所 
有 可 能 情况 ， 但 得 以 一 笑 编 译 器 如 何 处 理 控 制 流 。 


6.3.1  await 表 达 式 之 间 的 控制 流 很 简单 


在 讨论 复杂 的 内 容 之 前 ， 先 给 出 一 个 示例 。 该 示例 新 增 的 控制 流 不 增加 
生成 代码 的 复杂 度 〔 和 同步 代码 相 较 ) 。 示 例 代码 清单 6-6 引 入 了 循环 











控制 流程 ， 会 打印 3 次 Between delays。 
代码 清单 6-6 ”在 await 表 达 式 之 间 增 加 循环 
static async Task PrintAndwaitwithSimpleLoop(TimeSpan delay) 


Console.WriteLine("Before first delay"); 
await Task.Delay(delay); 
for (int i = 0; i < 3; i+t+) 


Console.WriteLine("Between delays"); 


await Task.Delay(delay); 
Console.WriteLine("After Second delay"); 


了 


这 段 代码 反 编 译 之 后 会 得 到 什么 结果 ? 和 代码 清单 6-2 很 像 ， 仅 有 的 区 
别 殉 是 从 : 
GetFirstAwaitResult: 

awaiter1.GetResult( ); 


Console.writeLine("Between delays"); 
TaskAwaiter awaiter2 = Task.Delay(this.delay).GetAwaiter(); 


要 风帆 


GetFirstAwaitResult: 
awaiter1.GetResult( ); 
for (int i = 0; i < 3; i++) 
{ 


Console.writeLine("Between delays"); 


TaskAwaiter awaiter2 = Task.Delay(this.delay).GetAwaiter(); 


原 代码 所 发 生 的 变化 与 状态 机 生成 代码 的 变化 完全 相同 。 就 续 延 的 执行 
方式 而 言 ， 并 没有 增加 任何 额外 字段 和 复杂 上 度 ， 只 是 新 增 了 一 个 普通 循 
环 。 


这 个 示例 则 在 让 读者 思考 接 下 来 的 示例 为 何 会 引入 额外 的 复 森 性。 在 代 
码 清 单 6-6 中 ， 控 制 流 不 需要 从 循环 外 部 跳 转 到 循环 内 部 ， 也 不 需要 在 
暂停 时 跳出 人 循环。 只 有 在 循环 内 部 使 用 await 才 会 发 生 这 种 跳 转 。 下 面 


一 探究 竟 。 


6.3.2 ”在 循环 中 使 用 await 


示例 代码 目前 包含 两 个 await 表 达 式 。 首 先 把 await 表 达 式 的 调用 缩减 到 
一 个 ， 因 为 目前 的 代码 有 些 复杂 。 接 下 来 要 进行 反 编 译 的 代码 如 下 。 


代码 清单 6-7 在 循环 中 使 用 await 


static async Task AwaitInLoop(TimeSpan delay) 








Console.WriteLine("Before loop"); 
for (int i = 0; i < 3; i++) 


Console.WriteLine("Before await in loop"); 
await Task.Delay(delay); 
Console.WriteLine("After await in loop"); 


} 
Console.WriteLine("After loop delay"); 


代码 中 的 console .writeLine 调 用 起 路 标的 作用 ， 方 便 我 们 在 原 代 人 友和 生 
成 代码 之 间 进 行 对 应 


编译 器 会 生成 怎样 的 代码 呢 ? 这 里 不 会 列 出 完整 的 生成 代码 ， 因 为 其 中 
大 部 分 内 容 和 之 前 的 示例 类 似 〈( 完 整 示 例 见 随 书 代码 ) 。 桩 方法 以 及 状 
态 机 和 前 面 给 出 的 内 容 儿 于 元 爹 相同 ， 只 是 在 状态 机 中 增加 了 (循环 
变量 ) 对 应 的 字段 。 需要 重点 关注 MoveNext() 方 法 。 


完全 可 以 不 使 用 循环 结构 体 来 表示 生成 的 代码 。 这 样 做 会 遇 到 一 个 问 

题 : 当 状 态 机 在 Task.Delay 从 和 暂停 恢复 之 后 ， 再 要 跳 转 到 原始 的 循环 当 
中 。 但 是 在 C# 中 无 法 使 用 goto 语 句 来 实现 ， 因 为 根据 语言 规则 ， 如 宁 

goto 语 句 不 在 东 标 签 的 作用 域 中 ， 那 么 不 多 许 使 用 goto 跳 转 到 该 标签 

hy 














可 以 在 不 引入 额外 作用 域 的 前 提 下 使 用 大 量 goto 语 句 来 实现 for 循 环 ， 
这 样 就 可 以 实现 0 ot 的 跳 转 了 。 代 码 清单 6-8 是 MoveNext() 方 法 体 
ee 吉 琳 。 只 给 出 了 try 块 中 的 部 分 代码 ， 因 为 这 是 当前 


代码 清单 6-8 ”将 循环 反 编译 ， 其 结 末 不 包含 任何 循环 结构 体 


switch (num) 


default: 
goto MethodStart; 
case 0: 
goto AwaitContinuation,; 


} 
MethodStart : 

Console.WriteLine("Before loop"); 

this.i = 0; <------ for 循 环 初始 化 

goto ForLoopCondition; <------ 直接 跳 转 到 检查 循环 条 件 
ForLoopBody: <------ for 循 环 体 


Console.WriteLine("Before await in loop"); 
TaskAwaiter awaiter = Task.Delay(this,.delay).GetAwaiter(); 
If (awaiter.IsCompleted) 


goto GetAwaitResult; 
} 


this.state = num = 0; 
this.awaiter = awaliter 
this.builder.AwaitUnsafeOnCompleted(ref awaiter, ref this); 
return; 

AwaitContinuation; <------ 当 状 态 机 恢复 时 跳 转 的 目标 位 置 
awaiter = this.awaiter,; 
this.awaiter = default(TaskAwaiter); 
this.state = num = -1; 

GetAwaitResult: 
awaiter.GetResult( ); 
Console.writeLine("After await in loop"); 
this.i++; <------ for 循 环 迭 代 器 

ForLoopCondition: (本 行 及 以 下 4 行 ) 检查 循环 条 件 ， 跳 转 回 循环 体 
if (this.i < 3) 
{ 

goto ForLoopBody; 


Console.WriteLine("After loop delay"); 


本 不 打算 介绍 这 个 示例 ， 但 其 中 有 些 内 容 非常 有 趣 ， 值 得 一 提 。 首 先 ， 
C# 编 译 器 不 会 把 async 方 法 转换 成 对 等 的 不 使 用 async/await 的 C# 代 码 ， 
它 只 会 生成 适当 的 瑟 代 码 。 有 时 C# 的 语言 规则 比 开 更 严格 〈 比 如 说 前 文 
提 到 的 合法 标识 符 的 问题 ) 。 


其 次 ， 尽 管 反 编译 器 在 查看 async 代 码 时 很 有 用 ， 但 有 时 反 编 译 器 会 生 
成 非法 的 C# 代 码 。 我 第 一 次 反 编译 代码 清单 6-7 时 ， 所 得 结果 中 有 一 个 
包含 代码 标签 的 while 循 坏 ， 循 环 外 部 有 一 条 goto 语 句 用 于 跳 转 到 循环 
内 部 。 有 时 可 以 对 反 编译 器 进行 设置 ， 以 确保 它 不 会 生成 非法 的 C# 代 














码 ， 但 这 样 的 代码 非常 难以 阅读 ， 其 中 会 包含 巨 量 的 goto 语 句 。 


再 则 ， 读 者 不 太 会 想 手写 此 类 代码 。 如 果 使 用 C# 4， 那 么 实现 方式 肯定 
会 大 不 相同 ， 而 且 写 出 的 代码 也 不 及 使 用 C# 5 async 方 法 的 代码 美观 。 


在 循环 中 使 用 await 对 编程 人 员 来 说 大 有 压力 ， 但 对 于 编译 器 而 言 不 过 


控制 流 的 最 后 一 个 例子 是 关于 try/finally 块 的 ， 难 度 有 所 
0。 


6.3.3 ”在 try/finally 块 中 使 用 await 表 达 式 


友情 提示 : 在 try 块 中 使 用 await 是 完全 合法 的 ， 但 是 在 C# 5 中 ， 在 catch 
块 或 finally 块 中 使 用 await 是 非法 的 。C# 6 取消 了 这 一 限制 ， 这 里 就 不 
提供 相关 示例 了 。 


说 明 try/catch 块 所 涉 可 能 情况 繁多 。 本 章 旨 在 介绍 C# 编 译 器 处 
理 async/await 人 代码 的 机 制 ， 而 不 会 全 面 展示 各 种 转换 方式 。 
下 面 只 给 出 关于 try 块 中 使 用 await 的 例子 ， 并 且 try 块 只 带 一 个 finally 
块 。 这 是 try 块 最 常见 的 用 法 ， 因 为 它 是 using 语 句 所 对 应 的 方式 。 请 看 
如 下 async 方 法 。 再 次 强调 ，console 方 法 仅 用 于 帮助 理解 状态 机 的 工作 
原理 。 


代码 清单 6-9 在 try 块 中 使 用 await 


static async Task AwaitInTryFinally(TimeSpan delay) 














Console.writeLine("Before try block"); 

await Task.Delay(delay); 

try 

{ 
Console.writeLine("Before await"); 
await Task.Delay(delay); 
Console.writeLine("After await"); 


} 
finally 
Console.writeLine("In finally block"); 


} 
Console.writeLine("After finally block"); 


反 编 译 后 的 代码 如 下 : 
Switch (num ) 
default: 
goto MethodStart; 
case 0: 
goto AwaitContinuation,; 
} 
MethodStart : 
try 
{ 
AwaitContinuation: 


GetAwaitResult: 
finally 


; ee 


其 中 省 略 号 〈...) 表示 省 略 了 一 些 代 码 。 不 过 这 里 有 一 个 问题 : 即便 

是 在 苇 中 ， 也 不 能 从 try 块 外 跳 转 到 try 块 内 部 。 这 个 问题 有 点 类 似 于 前 

| 但 是 这 次 不 是 受 限 于 C# 语 言 规则 ， 而 是 受 限 于 工本 
规则 。 


为 了 实现 try 块 的 跳 转 ，C# 顷 详 项 使 用 了 一 个 扩 巧 ， 我 将 其 形象 地 称 
为 “蹦床 ”( 这 不 是 官方 术语 ， 不 过 该 术语 在 其 他 类 似 的 功能 中 有 应 
用 ) : 控制 流 首 先 跳 转 到 紧 挨 try 块 最 前 面 的 位 置 ， 然 后 由 try 块 中 的 第 
一 块 代码 负责 跳 转 到 try 块 内 部 的 指定 位 置 。 


除了 “蹦床 "?， 也 需要 慎重 处 理 finally 块 。finally 块 的 生成 代码 在 以 下 3 
种 情况 下 会 被 执行 : 


。 执行 到 了 try 块 的 末尾 ; 
。 try 块 抛 出 了 异 名 ; 
。 await 表 达 式 需要 在 try 块 中 暂停 。 


(如 果 async 方 法 包含 了 一 条 return 语 句 ， 那 么 会 采取 另 一 种 方式 。) 如 





果 是 因为 暂停 了 状态 机 需要 返回 到 调用 方 ， 此 时 原 async 方 法 的 finally 
块 将 不 会 执行 。 这 是 因为 try 块 中 的 代码 只 是 暂停 了 ， 之 后 还 需要 在 这 
一 位 置 重新 恢复 执行 。 还 好 这 种 情况 很 容易 检测 到 : 如 果 状 态 机 仍 在 执 
行 ， 那 么 num 局 部 变量 《和 state 字 段 值 永远 保持 一 致 ) 为 负 值 ， 如果 状 
态 机 和 暂停， 那么 num 为 非 负 值 。 


于 是 得 到 了 代码 清单 6-10 (当然 ， 依 然 只 是 MoveNext() 外 层 的 try 块 中 的 
代码 ) 。 虽 然 其 中 省 略 了 很 多 代码 ， 不 过 这 部 分 代码 和 前 面 给 出 的 十 分 
类 似 。 代 人 码 清 单 6-10 中 try/finally 块 相关 部 分 已 加 粗 。 


代码 清单 6-10 ”try/finally 块 中 使 用 await 表 达 式 反 编译 结 


switch (num) 














default: 
goto MethodStart; 
case 0: 
goto AwaitcontinuationTrampoline; <------ 跳 转 到 蹦床 之 育 


} 
MethodStart: 
Console.WriteLine("Before try"); 
AwaitContinuationTrampoline: 
try 


switch (num) (本 行 及 以 下 7 行 ) try 块 中 的 蹦床 


default: 

goto TryBlockStart; 
case 0: 

goto AwaitContinuation; 


} 
TryBlockStart: 
Console.writeLine("Before await"); 
TaskAwaiter awaiter = Task.Delay(this.delay).GetAwaiter() 
if (awaiter.IsCompleted) 


{ 
goto GetAwaitResult; 


this.state = num = 0; 
this.awaiter = awaliter 
this.builder.AwaitUnsafeOnCompleted(ref awaiter, ref this 
return; 

Awaitcontinuation: <------ 真正 的 续 延 目标 
awaiter = this.awaiter,; 
this.awaiter = default(TaskAwaiter); 





this.state = num = -1; 
GetAwaitResult: 

awaiter.GetResult( ); 

Console.writeLine("After await"); 


} 
finally 
{ 





if (num < 9) (本 行 及 以 下 4 行 ) 暂停 期 间 忽 略 finally 块 
{ 


Console.writeLine("In finally block"); 


Console.writeLine("After finally block"); 


这 是 本 章 最 后 一 段 反 编译 代码 。 和 希望 这 些 反 编 译 代码 可 以 帮助 读者 在 需 
要 碍 看 反 编 译 代 码 时 理 清 头 绪 。 在 查看 这 类 代码 时 要 保持 头脑 清醒 ， 而 
且 要 记 住 编 译 器 默默 地 为 我 们 做 了 大 量 转换 工作 ， 远 甚 于 本 章 所 述 。 前 
文 提 过 ， 我 倾 问 于 使 用 switch 语 句 来 实现 <* 跳 转 到 某 位 置 >? 这 样 的 功能 ， 
不 过 编译 器 有 时 会 使 用 更 简单 的 分 文 代码 。 保 证 多 场景 中 代码 的 一 致 性 
对 于 代码 的 阅读 体验 十 分 重要 ， 对 于 编译 器 来 说 无 所 谓 。 


截 公 目前， 还 有 一 点 没有 解释 ， 那 就 是 awaiter 为 什么 在 可 以 实现 
ICriticalNotifycompletion 接 口 的 情况 下 选择 了 实现 INotifycompletion 
接口 ， 以 及 这 种 选择 对 生成 代码 产生 的 有 影响， 下面 详 述 


6.4 执行 上 下 文 和 执行 流程 


5.2.2 市 介绍 了 同步 上 下 文 ， 同步 上 下 文 用 于 守护 代码 执行 所 在 的 线程 。 
同步 上 下 文员 4 是 .NET 中 众多 上 下 文 类 型 之 一 ， 只 不 过 它 更 广为人知 。 上 
下 文 提供 了 一 种 维护 上 下 文 信息 透明 的 方式 。 例 如 securitycontext 会 退 
踩 当 前 安全 主体 并 确保 代码 访问 安全 。 我 们 无 有 顷 将 所 有 信息 显 式 传 入 ， 
它 会 奶 踩 我 们 的 代码 并 完成 自己 的 工作 。 其 中 的 Executioncontext 用 于 
管理 其 他 所 有 上 下 文 。 


知识 盲区 


我 本 不 打算 编写 本 节 内 容 ， 因 为 我 对 这 部 分 知识 掌握 有 限 。 如 果 读 
痢 想 深入 了 解 更 多 细节 ， 建 议 参考 其 他 资料 。 


不 过 最 后 还 是 决定 加 入 这 部 分 内 容 ， 人 否则 不 好 解释 像 builder 中 为 什 









































么 既 有 Awaitoncompleted 义 有 Awaitunsafeoncompleted 这 样 的 问 
题 ， 或 者 awaiter 为 什么 通常 需要 实现 TIcriticalNotifyCcompletion 接 
口 这 样 的 问题 。 


要 点 回顾 : Task 和 Task<T> 管 理 毛 有 被 await 的 task 的 上 下 文 。 如 果 处 于 UI 
线程 并 且 await 了 一 个 task，async 方 法 的 续 延 束 会 在 UI 线程 中 执行 。 可 以 
使 用 Task.configureAwait 来 切 出 UI 线程 执行 ， 这 样 做 等 于 显 式 地 表 

达 “ 我 清楚 当前 方法 的 其 余部 分 无 须 在 同一 个 同步 上 下 文中 执行 ?。 执 行 
上 下 文 (execution context) 的 情况 则 不 同 ， 总 是 需要 当 async 方 法 恢复 

执行 时 ， 代 码 能 够 在 同一 个 执行 上 下 文中 《即使 不 在 同一 个 线程 中 ) 运 
行 


对 执行 上 下 文 的 维护 过 程 ， 称 为 "贯穿 ”(flow) 。 执 行 上 下 文 会 从 await 
表达 式 中 贯穿 ， 这 意味 着 所 有 代码 都 会 在 同一 个 执行 上 下 文 运 行 。 那 么 
如 何 保证 执行 上 下 文 的 贯穿 性 昵 ? AsyncTaskMethodBuilder 可 以 总 是 确 
保 ，TaskAwaiter 有 了 时 可 以 确保 。 


INotifyCompletion.0ncompleted 方 法 是 一 个 普通 的 方法 ， 谁 都 可 以 调 
用 。 但 IcriticalNotifyCompletion.UnsafeonCcompleted 方 法 会 被 
[Securitycritical] 所 标记 。 它 只 能 由 可 信 的 代码 调用 ， 例 如 framework 
的 AsyncTaskMethodBuilder 类 。 


如 果 我 们 自行 编写 awaiter 类 并 且 关 注 代 码 运 行 的 正确 性 与 安全 性 (尤其 
是 可 信 的 运行 环境 ) ) 就 需要 保证 INotifyCompletion.0ncompleted 代 三 
可 以 贯穿 整个 执行 上 下 文 〈 通 过 Executioncontext ,Capture 和 
EXxecutionCcontext .Run) 。 也 可 以 实现 IcriticalNotifycompletion 然 后 
不 做 员 容 ， 让 异步 基础 架构 来 负 贡 保证 。 这 也 是 只 有 异步 基础 染 构 使 用 
awaiter 时 的 一 种 优化 策略 。 这 是 因为 如 果 只 需要 一 次 操作 就 能 保证 执行 
上 下 文 的 一 致 性 ， 就 不 必 做 两 次 。 


在 编译 async 方 法 时 ， 编 译 器 会 为 每 个 await 表 达 式 都 创建 一 个 对 
builder ,Awaitoncompleted 或 者 builder .AwaitUunsafeoncompleted 方 法 

(依据 awaiter 是 否 实 现 了 ICriticalNotifyCcompletion 接 口 ) 的 调用 。 
这 些 builder 方 法 都 是 具有 类 型 约束 的 泛 型 方法 ， 可 以 保证 传 入 的 awaiter 
实现 了 正确 的 接口 。 


如 末 读 者 实现 自 定 义 task 类 型 〈 除 了 教学 目的 ， 几 乎 很 少 有 这 样 的 需 
求 ) ， 那么 需要 遵循 和 AsyncTaskMethodBuilder 相 同 的 模式 : 

















在 Awaitoncompleted 和 AwaituUnsafeoncompleted 中 捕获 执行 上 下 文 ， 然 
后 就 可 以 放心 调用 IcriticaLlNotifyCompletion.UnSsafeonCompleted 了 。 
介绍 完 编译 器 使 用 AsyncTaskMethodBuilder 的 方式 后 ， 下 面 看 看 创建 自 
定义 task builder 都 有 哪些 要 求 。 


6.5 ”再 探 日 定义 task 类 型 


代码 清单 6-11 是 从 代码 清单 5-10 截 取 的 builder 部 分 。 第 5 章 首 次 谈 到 了 自 
定义 task 类 型 。 在 学 习 过 诸多 编译 的 状态 机 代码 之 后 ， 再 看 这 些 方法 就 
会 感到 很 亲切 了 。 可 以 把 本 节 内 容 当 作对 AsyncTaskMethodBuilder 方 法 
的 复习 ， 因 为 编译 器 处 理 所 有 builder 的 方式 都 是 相同 的 。 


代码 清单 6-11 一 个 简单 的 目 定 义 task 类 型 


public class CustomTaskBuilder<T> 


t 








public static CustomTaskBuilder<T> Create(); 

public void Start<TStateMachine>(ref TStateMachine stateMachi 
where TStateMachine : IAsyncStateMachine; 

public CustomTask<T> Task { get; } 


public void AwaitonCompleted<TAwaiter, TStateMachine> 
(ref TAwaiter awaiter, ref TStateMachine stateMachine) 
where TAwaiter : INotifyCompletion 
where TStateMachine : IAsyncStateMachine; 

public void AwaitUnsafeOnCompleted<TAwaiter, TStateMachine> 
(ref TAwaiter awaiter, ref TStateMachine stateMachine) 
where TAwaiter : INotifyCompletion 
where TStateMachine : IAsyncStateMachine; 

public void SetStateMachine(IAsyncStateMachine stateMachine); 


public void SetException(Exception exception); 


public void SetResult(T result); 
} 


上 述 方法 都 是 按照 调用 顺序 排列 的 。 


桩 方法 调用 create 来 创建 builder 实 例 ， 用 作 新 创建 状态 机 的 一 部 分 。 然 
后 它 调 用 start 让 状态 机 执行 第 一 步 并 返回 Task 属 性 的 结果 。 


在 状态 机 内 部 ， 每 个 await 表 达 式 都 会 创建 一 个 对 Awaitoncompleted 
或 Awaitunsafecompleted 方 法 的 调用 ， 前 面 讲 过 这 一 点 。 我 们 想象 一 个 


类 似 于 task 的 设计 : 第 一 个 调用 最 终 会 调 

用 IAsyncstateMachine.SetstateMachine， 然 后 调用 builder 的 
SetSstateMachine， 这 样 所 有 装 箱 操 作 都 可 以 保持 一 致 。 详 情 参见 6.1.4 
区 


最 后 ， 状 态 机 会 通过 调用 setException 或 者 SetResult 来 指示 异步 操作 的 
完成 。 最 后 的 状态 应 该 由 原始 的 桩 方法 来 生成 。 


本 章 是 本 书 截 至 目前 内 容 最 艰深 的 一 章 。 其 他 章 没 有 如 此 详细 地 和 查看 C# 
编译 喜 生 成 代码 。 对 于 很 对 开 及 人 员 来 说 ， 本 章 内 容 其 至 有 些 多 余 ， 因 
为 即使 不 学 习 这 些 实现 机 制 ， 也 不 妨碍 编写 正确 的 C# 异 步 代 码 。 不 管 怎 
样 ， 还 是 希望 本 章 可 以 对 那些 有 强烈 探 完 欲 的 读者 有 所 局 发 。 你 可 能 永 
远 不 需要 反 编 谋生 成 代码 ， 但 是 了 解 其 背后 机 制 总 是 会 有 所 神 蔡 。 如 果 
读者 有 一 天 需要 碍 看 这 些 代 码 ， 和 希望 本 章 内 容 有 助 于 理解 。 


步 特性 作为 C# 5 的 主要 特性 ， 后 据 了 本 书 两 章 的 篇 幅 。 第 7 章 的 内 容 
全 简短 很 多 届时 将 介绍 C# 5 的 其 余 两 个 特性 。 在 哺 完 异步 这 块 硬骨头 
之 后 ， 后 面 的 内 容 会 轻松 很 多 。 

















6.6 小结 
e 人 基础 架构 ，async 方 法 会 被 转换 成 桩 方法 和 状态 


。 状态 机 会 退 踪 builder、 方 法 参数 、 局 部 变量 、awaiter 以 及 续 延 中 需 
要 恢复 执行 的 位 置 。 

编译 器 会 创建 一 些 代码 ， 旨 在 在 方法 恢复 时 回 到 方法 内 部 。 

INotifycompletion 和 ICriticalNotifycompletion 接 口 可 用 于 控制 执 

行 上 下 文 的 贯穿 。 

。 自 定义 的 task builder 方 法 由 编译 堪 负 责 调 用 。 





第 7 章 C#5 附 加 特性 


本 章 内 容 概览 


。 foreach 循 环 中 关于 变量 捕获 的 变更 ; 
。 调用 方 信息 attribute。 


如 果 C# 在 设计 时 考虑 得 更 周全 ， 那 么 本 章 内 容 将 不 会 存在 。 我 希望 把 本 
章 作 为 C# 5 和 C# 6 这 两 道 大 餐 之 间 的 调剂 ， 但 事实 上 C# 5 还 有 两 个 补充 
特性 需要 单独 阐述 ， 它 们 不 能 归 入 异步 话题 。 第 一 个 特性 甚至 算 不 上 特 
性 ， 它 属于 前 期 语言 设计 的 一 处 缺陷 修正 。 


7.1 ”在 foreach 循 坏 中 捕获 变量 


在 C# 5 之 前 ， 根 据 语 言 规范 中 对 foreach 循 环 的 描述 ， 每 个 foreach 循 环 
都 只 会 声明 一 个 选 代 变量 ， 该 变量 在 原始 代码 中 是 只 读 的 ， 但 之 后 每 次 
迭代 都 会 赋 一 个 新 值 。 例 如 在 foreach 中 迭代 一 个 List<string> 的 C# 3 代 
码 如 下 所 示 : 


foreach (string name in names ) 








Console.WriteLine(name); 











} 
大 致 等 同 于 : 
String name; <------ 声明 单个 迭代 变量 
using (var iterator = names.GetEnumerator()) <------ 不 可 见 的 迭代 变 ] 
while (iterator.MoveNext()) 
name = iterator.Current; <------ 每 次 从 代 将 新 值 赋 给 迭代 变量 
Console.WwriteLine(name); <------ 原始 的 foreach 循 环 体 
} 
} 


说 明 ”语言 规范 中 还 有 其 他 许多 细节 描述 ， 例 如 集合 及 其 元 系 的 类 
型 转换 等 ， 不 过 这 些 内 容 均 与 本 特性 无 天。 兄 外 ， 友 代 变 量 的 作用 


品 


域 与 循环 的 作用 域 保持 一 致 ， 可 以 把 它 想象 成 整 段 代码 外 层 有 一 对 
大 括号 。 

这 样 的 设计 在 C# 1 中 是 没有 问题 的 ， 但 是 当 C# 2 引入 匿名 方法 之 后 就 出 
现 问 题 了 。 因 为 自 此 变量 可 以 被 捕获 ， 所 以 变量 的 生命 周期 发 生 了 颠覆 
性 的 变化 。 匿 名 方法 中 的 变量 会 被 捕获 ， 编 译 器 需要 在 幕后 完成 这 项 工 
作 以 便 更 自然 地 使 用 变量 。 虽 然 C# 2 的 匿名 方法 大 有 用 处 ， 但 在 我 印象 
中 ， 直 到 C# 3 引入 lambda 表 达 式 和 LINQ 之 后 ， 委 托 这 项 特性 才 真 正 得 
到 了 广泛 应 用 。 


前 面 把 foreach 循 环 展 开 的 例子 中 ， 只 使 用 一 个 迭代 变量 有 什么 问题 
呢 ? 如 果 该 变量 被 茶 个 创建 委托 的 匿名 函数 所 捕获 ， 那 么 当 委 托 被 调用 
时 ， 委 托 使 用 的 都 是 该 变量 的 当前 值 ， 示 例如 下 。 


代码 清单 7-1 ”在 foreach 循 环 中 捕获 从 代 变 量 
List<string> names = new List<string> { "x", "y", "z" }; 


var actions = new List<Action>(); 
foreach (string name in names) <------ 迭代 names 列 表 








actions.Add(() => Console.writeLine(name)); <------ 创建 委托 捕手 





} 
foreach (Action action in actions) (本 行 及 以 下 3 行 ) 执行 所 有 委托 





action( ); 


按照 以 往 的 理解 ， 读 者 预计 打印 结果 会 是 什么 呢 ? 大 部 分 开发 人 员 会 认 
为 是 x，y，z， 因 为 只 有 这 样 才 符 合 代 码 意图 ， 但 事实 上 如 末 使 用 C#5 
之 前 的 编译 占 ， 结 果 会 是 打印 3 次 z， 并 非 理 想 行 为 。 


到 了 C# 5， 语 言 规范 修正 了 关于 foreach 循 环 的 表述 ， 这 样 每 次 循环 都 
会 引入 新 的 变量 ， 于 是 同样 的 代码 在 C# 5 及 之 后 就 会 打印 结果 x，y，z 
本 








请 注意 ， 这 项 修正 只 影响 foreach 循 环 。 如 果 使 用 普通 的 for 循 环 ， 那 么 
被 捕获 的 依然 是 一 个 变量 。 代 码 清 单 7-2 除 了 加 粗 的 部 分 ， 其 余 都 和 代 
码 清 单 7-1 相 同 。 


代码 清单 7-2 在 for 循 环 中 捕获 变量 


List<string> names = new List<string> { "x", "y", "z" }; 
var actions = new List<Action>(); 
for (int i = 0; i < names.Count; i++) <------ 迭代 names 列 表 





actions.Add(() => Console.WwriteLine(names[i])); <------ 创建 委 


} 
foreach (Action action in actions) (本 行 及 以 下 3 行 ) 执行 所 有 委托 





action( ); 


这 段 代 码 的 执行 结果 并 不 是 打印 3 次 z， 而 是 抛 出 一 
个 ArgumentoutOfRangeException， 因为 在 执行 委托 时 ， i 的 值 已 经 是 3 


这 并 不 是 C# 设 计 团 队 的 玖 忽 ， 而 是 有 意 为 之 ， 因 为 for 循 环 初 始 化 器 在 
整个 循环 周期 内 只 能 声明 一 次 循环 变量 。for 循 环 的 语法 给 人 的 感觉 是 
只 能 有 一 个 循环 变量 ， 而 foreach 循 环 的 语法 给 人 的 感 冰 是 每 次 迭代 都 
需要 声明 一 个 新 变量 。 下 面 介 绍 C# 5 的 最 后 一 个 特性 : 调用 方 信息 
attribute。 








7.2 ”调用 方 信息 attribute 


有 些 特性 通用 性 较 强 ， 比 如 lambda 表 达 式 、 隐 式 类 型 局 部 变量 、 泛 型 

等 ， 而 一 些 特性 更 具 针 对 性 ， 比 如 LINQ 用 于 查询 某 种 形式 的 数据 ， 虽 
然 它 能 够 针对 不 同 的 数据 源 进行 通 配 ， 但 依然 属于 特定 用 途 的 范畴 。C# 
5 的 最 后 一 个 特性 极 具 针 对 性 : 该 特性 主要 用 于 两 个 场景 〈 一 个 比较 明 
显 ， 另 一 个 不 那么 明显 ) ， 除 此 之 外 应 用 非常 有 限 。 


7.2.1 基本 行为 


.NET 4.5 引 入 了 3 个 新 的 attribute: 








ee CallerFilePpathAttribute 
ee CallerLineNumberAttribute 
e@ CallerMemberNameAttribute 


这 3 个 attribute 都 位 于 system.Runtime.CompilerServices 命 名 空间 下 。 与 


其 他 attribute 类 似 ， 在 应 用 时 可 省 上 略 Attribute 后 级 。 因 为 省 略 后 级 是 常 


规 做 法 ， 所 以 后 文 都 会 采取 省 略 用 法 。 


这 3 个 attribute 都 只 能 应 用 于 方法 形 参 ， 而 且 只 有 在 特定 类 型 的 可 选 形 参 
中 才能 发 挥 作 用 。 其 根本 思想 很 简单 : 如 果 调 用 方 没有 提供 实 参 ， 那 编 
译 右 会 默认 使 用 当前 文件 、 行 数 或 者 成 员 名 来 作为 实 参 ， 而 不 是 采用 通 
常 的 默认 值 。 如 果 调 用 方 提供 了 实 参 ， 那 么 编译 右 不 执行 额外 操作 。 


说 明 ”在 这 3 个 attribute 的 使 用 场景 中 ， 形 参 一 般 是 int 或 者 string 类 
型 ， 或 者 是 能 够 转换 为 这 两 者 的 其 他 类 型 。 丰 有 兴趣 深入 了 解 ， 可 
以 参考 编程 规范 中 的 相关 内 容 ， 但 这 类 需求 比较 鲜 见 。 


代码 清单 7-3 是 上 述 3 个 attribute 的 综合 示例 ， 其 中 还 有 由 编译 器 和 用 户 分 
别 指定 实 参 值 的 情况 。 


代码 清单 7-3 ”调用 方 成 员 attribute 的 基本 示例 


static void ShowInfo( 
[CallerFilePath] string file = null, 
[CallerLineNumber] int line = 0, 
[CallerMemberName|] string member = null) 





Console.writeLine("{0}:{1} - {2}", file, line, member); 


static void Main() 














ShowInfo(); <------ 由 编译 器 根据 上 下 文 提 供 3 个 实 参 
ShowInfo("LiesAndDamnedLies.java", -10); <------ 由 编译 器 根据 上 - 

















有 
在 我 的 计算 机 上 ， 执 行 结果 如 下 : 


C:\Users\jon\Projects\CSharpInDepth\ChapterO7\CallerIinfoDemo.cs:2 
LiesAndDamnedLies,java:-10 - Main 


一 般 说 来 ， 不 应 该 为 此 类 实 参 使 用 虚构 值 ， 不 过 当 需 要 使 用 同一 个 
attribute 来 记录 当前 调用 方 信息 时 ， 可 以 显 式 提供 实 参 值 。 
参数 名 通常 需要 与 其 含义 相对 应 。attribute 的 默认 值 一 般 来 说 并 不 重 


要 ， 但 7.2.4 市 会 探讨 几 个 有 意思 的 极端 案例 。 接 下 来 首先 介绍 之 前 说 的 
两 种 第 见 场景 ， 其 中 比较 普遍 的 一 种 场景 是 日 志 。 





7 2 刁 污 














调用 方 信息 的 常见 使 用 场景 是 记录 日 志文 件 。 在 该 特性 出 现 之 前 ， 当 需 
要 记录 日 志 时 ， 一 般 要 构建 一 个 调用 栈 〈 例 如 使 

用 System.Diagnostics.SstackTrace) 来 找 出 调用 方 信息 。 这 些 信息 一 般 
隐藏 在 日 志 框 架 背 后 ， 方 法 虽 不 其 优雅 ,但 终归 可 用 。 此 外 ， 还 可 能 造 
成 潜在 的 性 能 问题 ， 对 于 内 联 的 JIT 编 译 来 说 也 是 十 分 脆弱 的 。 


日 志 框架 使 用 新 特性 来 更 方便 地 记录 调用 方 信息 。 即 便 删 除了 调试 信息 
和 进行 代码 混淆 之 后 ， 依 然 能 够 将 行 号 以 成 员 名 保留 下 来 。 虽 然 这 项 特 
性 不 能 用 来 记录 整个 调用 校 信息 ， 但 是 我 们 可 以 通过 其 他 方式 实现 这 术 
需求 。 


2017 年 末 的 一 次 粗略 调查 显示 ， 这 项 功能 并 没有 得 到 广泛 应 用 1。 
ASP.NET Core 中 使 用 广泛 的 ILogger 也 尚未 普遍 采纳 该 特性 。 不 过 我 们 
可 以 通过 给 ILogger 编 写 扩展 方法 来 应 用 这 些 attribute 并 创建 合理 的 日 志 
状态 对 象 。 


1 据 我 所 知 ， 唯 一 直接 文 持 该 特性 的 日 志 框 如 是 NLog， 不 过 也 取决 于 目 
标 框 架 ， 有 条 件 限制 。 


项 目 工 程 有 时 会 包含 自己 的 日 志 框 架 ， 它 们 都 可 以 使 用 这 些 attribute。 
针对 特定 工程 的 日 志 框 架 并 不 需要 关心 目标 框架 是 否 包 含 这 些 
attribute。 


说 明 ”缺少 高 效 系 统 级 的 日 志 框 漆 是 一 个 棘手 的 问题 ， 对 于 类 库 纺 
程 人 员 而 言 更 是 如 此 ， 他 们 需要 为 目 己 的 类 库 提 供 日 志 功 能 ， 但 因 
为 不 知道 用 户 会 引用 哪个 日 志 框 及 ， 因 此 不 太 乐 意 添 加 第 三 方 库 的 
引用 。 


日 志 场 景 的 应 用 需要 考虑 框架 的 使 用 这 一 特殊 情况 ， 接 下 来 介绍 的 第 2 
个 场景 在 集成 时 则 容易 得 多 。 


























7.2.3 ”简化 INotifyPropertychanged 的 实现 


如 果 读 者 实现 过 INotifyPropertychanged， 对 [callerMemberName] 
attribute 应 该 比较 熟悉 。 访 接口 通常 用 于 厚 客户 端 应 用 (与 Web 应 用 相 
对 ) ， 使 UI 响应 模型 或 者 视图 模型 的 数据 变化 。 它 位 于 








System.ComponentMode1 命 名 空间 下 ， 不 与 任何 特定 的 UI 技 术 绑 定 。 它 季 
见于 Windows Forms、WPF 以 及 Xamarin Forms。 该 接口 很 简单 ， 它 就 
是 PropertychangedEventHandler 类 型 的 一 个 事件 ， 该 类 型 为 委托 类 型 ， 
该 类 型 签名 如 下 : 


public delegate void PropertyChangedEventHandler( 
Object sender, PropertychangedEventArgs e) 








PropertyChangedEventArgs 有 一 个 构造 器 : 


public PropertyChangedEventArgs(string propertyName ) 
在 C# 5 之 前 ，INotifyPropertyCchanged 接 口 的 典型 实现 如 下 所 示 。 
代码 清单 7-4 ”曾经 INotifyPropertychanged 的 实现 


class OldPropertyNotifier : INotifyPropertyChanged 

{ 
public event PropertyChangedEventHandler PropertyChanged; 
private int firstValue; 
public int FirstValue 


{ 
get { return firstValue; } 
set 
if (value != firstValue) 
firstValue = value; 
NotifyPropertyChanged("FirstValue"); 
} 
} 
} 


// (相同 模式 的 其 他 属性 ) 





private void NotifyPropertyChanged(string propertyName ) 


{ 
PropertyChangedEventHandler handler = PropertyChanged; 
if (handler != null) 


handler (this, new PropertyChangedEventArgs(propertyNa 





其 中 辅助 方法 用 于 避免 在 每 个 属性 中 都 做 重复 的 空 值 检查 。 可 以 把 它 改 
写成 扩展 方法 ， 以 避免 重复 实现 。 


这 样 的 代码 不 仅见 长 (变化 前 ) 而 且 不 够 稳健 。 问 题 就 在 于 Firstvalue 
属性 的 名 字 是 通过 字符 串 字 面 量 指定 的 ， 如 果 之 后 重 构 了 该 名 称 ， 会 很 
容易 筷 记 修改 这 里 的 字符 串 。 如 果 茶 些 工 具 或 者 测试 能 够 发 现 该 错误 ， 

那么 情况 还 不 算 糟 料 。 第 9 章 会 介绍 C# 6 引入 的 nameof 运 算 符 ， 它 可 以 

提升 这 段 代码 的 重 构 友 好 度 ， 不 过 依然 无 法 避免 在 复制 粘贴 时 出 错 。 


有 了 调用 方 信 息 attribute 之 后 ， 这 段 代 人 码 的 主体 不 用 改变 ， 而 我 们 可 以 
通过 在 辅助 方法 中 使 用 callerMemberName 来 让 编译 器 填写 属性 名 称 ， 修 
改 后 的 代码 如 下 所 示 。 

代码 清单 7-5 “使 用 调用 方 信 息 来 实现 INotifyPropertyChanged 


if (value != firstValue) (本 行 及 以 下 4 行 ) 属性 setter 访 问 器 的 内 部 变化 
{ 











firstValue = value; 
NotifyPropertyChanged( ); 


void NotifyPropertyChanged([CallerMemberName] string propertyName 





<------ 和 之 前 相同 的 方法 体 
= 


这 里 只 列 出 了 代码 修改 的 部 分 。 现 在 如 果 属 性 的 名 称 发 生变 化 ， 编 译 器 
就 会 使 用 新 的 属性 名 称 。 尽 管 不 是 什么 重大 改进 ， 但 人 至少 是 进步 。 


与 日 志 功 能 不 同 ，MVVM 和 采纳 了 该 模式 。MVVM 是 为 视图 模型 和 模型 
提供 基础 类 的 框架 ， 例 如 在 Xamarin Forms 中 ，Bindableobject 类 有 一 
个 onPropertychanged 方 法 就 使 用 了 callerMemberName。 类 似 地 ， 
Caliburn Micro MVVM 框 架 也 有 一 个 PropertyCchangedBase 类 包含 一 

个 NotifyofPropertyChange 方 法 。 关于 调用 方 信息 attribute， 了 解 这 些 内 
ee 不 过 这 项 特性 《尤其 是 调用 方 成 员 名 称 ) 还 有 一 些 很 小 众 的 用 
A 


7.2.4 ”调用 方 信息 attribute 的 小 众 使 用 场景 
绝 大 部 分 情况 下 ， 编 译 器 为 调用 方 信息 attribute 提 供 的 值 是 显而易见 











的 ， 对 于 不 显而易见 的 情况 ， 也 不 妨 了 解 一 下 。 这 里 需要 强调 的 是 ， 这 
部 分 内 容 主要 出 于 兴趣 一 一 研究 语言 设计 过 程 中 的 决策 取舍 问题 。 这 部 
分 内 容 对 日 常 编程 影响 其 小 。 首 先 介绍 一 项 小 的 限制 。 


1. 动态 调用 成 员 


动态 类 型 基础 架构 会 在 多 个 方面 努力 ， 来 让 代码 在 执行 期 的 行为 与 
编译 时 的 行为 保持 一 致 ， 但 调用 方 信息 并 不 用 于 此 目的 。 假 设 现在 
要 调 起 某 个 成 员 ， 该 成 员 包含 一 个 可 选 形 参 ， 该 可 选 形 参 使 用 了 调 
用 方 信息 attribute。 如 果 调 用 方 没有 提供 相应 实 参 ， 那 么 调用 方 信 
居 attribute 将 失去 作用 。 


抛 开 其 他 不 谈 ， 编 译 需 需要 为 每 个 动态 调用 的 成 员 都 伐 入 完整 的 行 
号 信息 ， 仅 为 应 对 可 能 的 行 号 请 求 ， 这 等 同 于 为 0.1% 的 可 能 需求 而 
增加 程序 集 的 大 小 ， 而 且 之 后 在 执行 期 检查 是 人 否 存 在 调用 方 信 息 请 
求 需 要 做 额外 的 分 析 ， 还 可 能 影响 缓存 。C# 设 计 团 队 当 初 如 果 考 虑 
到 这 类 场景 ， 那 么 可 能 会 采取 男 一 种 实现 方案 ， 不 过 他 们 也 许 认为 
应 当 把 时 间 和 精力 投 回 其 他 更 有 价值 的 特性 。 我 们 需要 做 的 就 是 知 
道 并 接受 它 的 存在 ， 不 过 在 某 些 场景 中 还 是 有 寺 回 解决 方案 的 。 


如 果 和 采 个 方法 调用 的 实 参 是 动态 类 型 ， 而 此 时 我 们 并 不 需要 参数 的 
动态 行为 ， 那 么 可 以 把 它 转换 成 合适 的 类 型 ， 这 样 就 可 以 将 把 该 调 
用 变 为 普通 方法 调用 ， 不 会 牵涉 动态 类 型 2。 如 果 动 态 行 为 不 能 省 
略 并 且 需 要 使 用 调用 方 信息 attribute， 我 们 可 以 显 式 地 调用 某 个 辅 
助 方法 ， 由 辅助 方法 通过 调用 方 信 息 attribute 来 返回 调用 方 信 息 。 

虽然 这 样 做 不 甚 优 雅 ， 但 毕竟 这 样 的 场景 很 罕见 。 代 码 清单 7-6 包 
含 了 问题 的 展示 及 其 迁 回 解决 方案 。 


代码 清单 7-6 ”调用 方 信息 attribute 和 动态 类 型 


static void ShowLine(string message，( 本 行 及 以 下 4 行 ) 即将 调用 的 、 
[CallerLineNumber] int line = 0) 
































Console.writeLine("{0}: {1}", line, message); 


} 


static int GetLineNumber( (本 行 及 以 下 4 行 ) 第 2 种 迁 回 方案 的 帮助 方法 
[CallerLineNumber] int line = 0) 








return line; 


} 
static void Main() 


dynamic message = "Some message"; 

ShowLine(message); <------ 简单 的 动态 调用 ， 行 号 为 0 

ShowLine( (string) message); <------ 第 1 种 迁 回 方案 : 使 用 类 型 转 
ShowLine(message, GetLineNumber()); <------ 第 2 种 迁 回 方案 : ， 











代码 清单 7-6 在 第 一 次 调用 时 打印 的 行 号 是 0(， 而 之 后 的 两 次 调用 都 
能 打印 正确 的 行 号 。 这 是 关于 保持 代码 简洁 还 是 保留 更 多 信息 的 一 
场 权衡 。 当 使 用 动态 重 载 决议 时 (有些 重 载 方法 需要 调用 方 信息 ， 
有 些 则 不 需要 ) ， 这 些 折 中 方法 就 不 再 适用 了。 我 认为 这 种 局 限 性 
尚 属 合理 。 下 面 看 一 些 不 同 寻 常 的 名 称 。 








. 非 “ 显 著 ?” 成 员 名 称 


当 调 用 方 是 一 个 方法 ， 并 且 由 编译 喜 提 供 了 调用 方 成 员 名 称 ， 那 么 
这 是 一 个 “显著 ?名 称 ， 即 方法 的 名 称 。 不 过 并 非 所 有 调用 方 都 十 方 
法 。 考 虑 以 下 情形 : 


。 从 实例 构造 器 中 调用 ; 

从 静态 构造 保 中 调用 ; 

从 终结 器 中 调用 ; 

从 运算 符 中 调用 ; 

作为 字段 、 事 件 或 者 属性 初始 化 器 的 部 分 调用 3; 
从 索引 器 中 调用 。 


前 4 种 情况 依赖 于 实现 方式 : 由 编译 器 决定 如 何 处 理 。 编 程 规 范 中 
未 说 明 第 5 种 情况 (初始 化 器 〉， 而 最 后 一 种 (索引 器 〉 按 规定 要 
以 Ttem 作 为 名 称 ， 除 非 IndexerNameAttribute 已 经 应 用 于 该 索引 
人 


对 于 前 4 种 情况 ，Roslyn 编 译 器 使 用 二 提供 的 名 
称 : ,Ctor、 .cctor、 Finalize 以 及 像 op_Addition 这 样 的 运算 符 名 
称 。 如 采 是 终结 器 ， 则 使 用 被 初始 化 的 字段 、 事 件 或 者 属性 的 名 


大 


子 





O Oo oO oO 


随 书 代码 中 包含 了 以 上 所 有 情况 的 完整 示例 。 这 里 没有 列 出 代码 ， 
因为 结论 远 比 代 码 本 身 更 有 意义 。 上 述 名 称 均 选 择 了 最 明显 的 名 

称 ， 不 同 编译 器 在 以 上 名 称 选择 上 基本 一 致 ， 不 过 在 一 个 方面 确实 
存在 差异 : 编译 右 填 充 这 些 调用 方 attribute 信 息 的 时 机 。 


. 隐 式 构造 器 调用 


C# 5 的 语言 规范 中 要 求 ， 只 有 当 函 数 在 源码 中 被 显 式 调用 时 才能 使 
用 调用 方 信息 ， 不 过 被 视 为 语法 扩展 的 查询 表达 式 除 外 。 其 他 那些 
基于 模式 的 C# 语 言 构建 本 就 不 适用 于 可 选 形 参 的 方法 ， 但 构造 器 初 
始 化 器 是 绝对 适用 的 。(12.2 节 会 介绍 C# 7 的 分 解 器 。) 语言 规范 
将 构造 器 作为 上 述 要 求 的 例子 ， 只 有 显 式 调用 时 ， 编 译 器 才 会 为 构 
造 器 提供 调用 方 信息 。 代 码 清单 7-7 包 括 了 一 个 抽象 基 类 、 使 用 了 
调用 方 信 息 的 构造 器 以 及 3 个 继承 类 。 


代码 清单 7-7 ”构造 器 中 的 调用 方 信 息 


public abstract class BaseClass 











protected BaseClass( <------ 基 类 构造 器 使 用 调用 方 信息 attribut 
[CallerFilePath] string file = "Unspecified file", 
[CallerLineNumber] int line = -1, 
[CallerMemberName] string member = "Unspecified membe 
{ 
Console.writeLine("{0}:{1} - {2}", file, line, member 
} 
} 
public class Derived1 : BaseClass { } <------ 无 参 构造 器 是 隐 式 添 


public class Derived2 : BaseClass 


public Derived2() { } <------ 隐 式 调用 base( ) 的 构造 器 
} 


public class Derived3 : BaseClass 


public Derived3() : base() {} <------ 显 式 调用 base( ) 的 构造 器 
} 


以 Roslyn 编 译 右 为 例 ， 只 有 Derived3 能 够 得 到 正确 的 调用 方 信息 ， 
而 Derived1 和 perived2 对 于 Baseclass 构 造 器 的 调用 都 属于 隐 式 调 


人 而 不 会 为 其 提供 文件 名 、 行 号 
[成 员 名 。 


虽然 这 符合 C# 5 的 语言 规范 ， 但 我 认为 这 是 一 个 设计 缺陷 ， 我 想 大 
部 分 开发 人 员 预 估 以 上 3 个 子 类 会 得 到 完全 一 致 的 结果 。 有 趣 的 
是 ，Mono 编 译 器 (mcs) 目前 已 经 能 做 到 这 一 点 了 。 接 下 来 就 要 看 
到 底 是 语言 规范 会 更 新 还 是 Mono 编 译 占 更 新 ， 或 者 这 种 不 兼容 的 
状况 将 长 期 持续 。 





. 得 询 表达 式 的 调用 


前 面 提 到 ， 语 言 规范 中 明确 强调 查询 表达 式 属 于 例外 : 即使 通过 隐 
式 调 用 ， 编 译 器 依然 会 提供 调用 方 信息 。 虽 然 该 特性 不 太 常用 ， 但 
随 书 代码 中 还 是 提供 了 一 个 完整 示例 。 代 码 清 单 7-8 是 完整 代码 的 
简化 版 。 

代码 清单 7-8 ”查询 表 达 式 中 的 调用 方 信息 
string[] source = 


"the", "quick", "brown", "fox", 
"jumped", "over", "the", "Jazy", "dog" 





var guery = from word :in source (本 行 及 以 下 2 行 ) 查询 表达 式 使 用 方法 
where word.Length > 3 
select word.ToUpperInvariant( ) ; 
Console.writeLine("Data:"); 
Console.writeLine(string.Join(", ", query)); <------ 打印 数据 
Console.writeLine("CallerIinfo:"); 
Console .WriteLine(string.Join( (本 行 及 以 下 1 行 ) 打印 query 的 调用 方 人 
Environment.NewLine, query.CallerIinfo)); 


尽管 这 只 是 一 个 常规 的 查询 表达 式 ， 我 还 是 引入 了 一 个 新 的 扩展 方 
法 《与 示例 代码 在 同一 个 命名 空间 下 ， 因 此 会 先 于 system.Linq 被 
查找 到 ) ， 其 中 包含 调用 方 信 息 attribute。 代 码 运 行 结 果 显 示 ， 碍 
询 表达 式 成 功 捕获 了 数据 和 调用 方 信 息 。 


Data : 

QUICK， BROWN， JUMPED， OVER， LAZY 
callerIinfo: 

CallerIinfoLinq.cs:91 - Main 








CallerIinfoLinq.cs:92 - Main 


这 一 行为 有 什么 用 吗 ? 实话 说 可 能 确实 没什么 用 。 这 里 则 在 展示 当 
语言 设计 者 需要 引入 新 特性 时 ， 需 要 慎重 考虑 很 多 情形 。 这 是 因为 
如 果 有 开发 人 员 需 要 从 碍 询 表达 式 中 获取 调用 方 信息 ， 而 此 时 编程 
规范 对 此 语 址 不 详 ， 束 很 令 人 头疼 了 。 至 此 ， 还 有 一 个 成 员 调 用 的 
情况 未 讨论 ， 它 比 构造 器 初始 化 器 和 查询 表达 式 更 为 细 校 术 节 ， 那 
就 是 attribute 初 始 化 。 








. 使 用 调用 方 信息 attribute 的 attribute 


我 以 前 倾 回 于 把 应 用 attribute 看 作 提 供 额 外 数据 的 一 个 特性 。 直 观 
而 言 ， 它 并 不 像 是 需要 调用 什么 ， 但 毕竟 attribute 本 身 也 是 代码 ， 
在 构建 attribute 对 象 时 一般 是 从 某 个 反射 调用 中 人 返回) ， 会 调用 
构造 器 和 属性 setter。 如 果 在 创建 attribute 时 使 用 调用 方 信息 
attribute， 那 么 调用 方 会 是 什么 呢 ? 下 面 一 探究 竟 。 


首先 需要 一 个 attribute 类 。 这 部 分 比较 简单 ， 见 代码 清单 7-9。 
代码 清单 7-9 ”捕获 调用 方 信息 的 attribute 类 


[AttributeUsage(AttributeTargets.A1ll)] 
public class MemberDescriptionAttribute : Attribute 





public MemberDescriptionAttribute( 
[CallerFilePath] string file = "Unspecified file", 
[CallerLineNumber] int line = 0, 


[CallerMemberName] string member = "Unspecified membe 
{ 

File = file; 

Line = line; 

Member = member; 
} 


public string File { get; } 
public int Line { get; } 
public string Member { get; } 


public override string ToString() => 
$"{Path.GetFileName(File)}:{Line} - {Member}"; 





方便 起 见 ， 该 类 使 用 了 C# 6 的 一 些 特性 ， 不 过 这 不 是 重点 。 这 里 
要 关注 构造 器 参数 使 用 了 调用 方 信息 attribute。 


当 应 用 这 个 新 的 MemberDescriptionAttribute 时 会 发 生 什 么 呢 ? 
码 清单 7-10 中 把 该 attribute 应 用 于 另外 一 个 类 及 其 各 个 方法 中 ， 然 后 
看 看 会 发 生 什 么 。 

代码 清单 7-10 将 attribute 应 用 于 类 和 方法 中 


using MDA = MemberDescriptionAttribute; <------ 简化 反射 代码 





[MemberDescription] (本 行 及 以 下 1 行 ) 应 用 了 attribute 的 类 
class CallerNameInAttribute 


{ 











[MemberDescription] (本 行 及 以 下 3 行 ) 通过 各 种 方式 对 方法 应 用 attrj 
public void Method<[MemberDescription] T>( 
[MemberDescription] int parameter) { } 


static void Main() 

{ 
var typeInfo = typeof(CallerNameInAttribute),.GetTypeI 
var methodInfo = typeInfo.GetDeclaredMethod("Method") 
var paramInfo = methodIinfo.GetParameters()[0]; 
var typeParamInfo = 

methodInfo.GetGenericArguments()[0].GetTypeIinfo() 

Console.writeLine(typeInfo.GetCustomAttribute<MDA>()) 
Console.writeLine(methodIinfo.GetCustomAttribute<MDA>( 
Console.writeLine(paramInfo.GetCustomAttribute<MDA>() 
Console.writeLine(typeParamInfo.GetCustomAttribute<MD 


在 Main 方 法 中 使 用 了 反射 来 获取 所 有 被 应 用 的 attribute。 也 可 以 把 
MemberDescriptionAttribute 应 用 于 别处 ， 比如 字段 、 属 性 、 索 引 
颖 等 。 读 者 可 以 对 随 书 代码 中 提供 的 示例 进行 各 种 试验 ， 探 究 其 背 
后 机 制 。 在 前 面 的 例子 中 ， 编 译 器 都 完美 地 捕获 了 行 号 和 文件 路 
径 ， 但 它 并 没有 把 类 名 作为 成 员 名 ， 因 此 打印 结果 为 : 


CallerNameInAttribute.cs:36 - Unspecified member 
CallerNameInAttribute.cs:39 - Method 
CallerNameInAttribute.cs:40 - Method 
CallerNameInAttribute.cs:40 - Method 


这 部 分 内 容 在 C# 5 编程 规范 中 有 所 阐述 ， 它 扩展 了 关于 attribute 应 











用 于 函数 成 员 《〈 方 法 、 属 性 、 事 件 等 ) 而 不 是 类 型 中 的 行为 。 如 宋 
能 够 把 类 型 的 相关 行为 也 包含 进来 ， 束 更 完美 了 。 类 型 属于 命名 空 
闻 的 成 员 ， 因 此 类 型 名 称 也 可 以 和 成 员 名 称 形成 映射 关系 。 


再 次 强调 ， 这 部 分 内 容 是 出 于 章节 内 容 的 完整 性 而 设 ， 重 点 讨论 了 
语言 设计 中 的 各 种 取舍 。 何 时 需要 为 了 减少 实现 的 工作 量 而 接受 间 
分 局 限 性 ? 何 时 语言 设计 的 选择 可 以 不 得 已 背离 用 户 预期 ? 何 时 语 
言 规范 中 可 以 显 式 地 将 某 个 决定 转换 为 实现 层面 ? 在 宏观 层面 讲 ， 
设计 团队 需要 为 某 个 极端 情况 付出 多 少时 间 成 本 ? 至 此 ， 还 有 最 后 
了 个 实 下 居 面 的 细节 问题 ;在 个 存在 stuibute 的 框架 中 启用 该 和 


2 如 此 一 来 ， 方 法 调用 还 能 导 有 编译 时 检查 ， 可 以 检查 成 员 是 否 存在 ， 
还 能 提高 执行 效率 。 


3 自动 实现 属性 的 初始 化 器 由 C# 6 引入 。 更 多 细节 ， 人 参见 8.2.2 节 。 目 前 
可 以 对 “自动 实现 属性 ”顾名思义 ”。 


7.2.5 ”旧版 本 .NET 使 用 调用 方 信 息 attribute 


希望 现在 大 部 分 读者 使 用 的 .NET 版 本 是 .NET 4.5+ 或 者 .NET Standard 
1.0+， 因 为 它们 都 包含 了 调用 方 信 息 attribute， 但 在 某 些 情况 下 ， 也 会 不 
得 已 使 用 新 版 编译 器 搭配 旧版 framework。 


此 时 依然 可 以 使 用 调用 方 信息 attribute， 需 要 做 的 就 是 让 编译 器 识别 出 
这 些 attribute。 最 简单 的 办 法 就 是 使 用 Microsoft.Bcl1 NuGet 包 ， 访 包 提 
供 了 上 述 attribute 以 及 新 版 framework 的 其 他 很 多 特性 。 


如 果 因 为 某 些 原因 无 法 使 用 NuGet 包 ， 也 可 以 上 自行 提供 这 些 attribute。 这 
些 attribute 都 很 简单 ， 既 不 售 参 数 ， 也 不 需要 属性 ， 从 API 文 档 中 直接 复 
制 其 声明 即 可 ， 然后 把 它们 放置 在 system.Runtime,.CompilerServices 命 
名 空间 下 。 在 此 之 前 ， 需 要 确认 当前 系统 没有 提供 这 些 attribute， 否 则 
会 出 现 命 名 冲突 。 这 个 过 程 比 较 复 保 (与 版 本 有 关 的 所 有 问题 都 很 复 
杂 ) ， 相 关 细 节 超 出 了 本 书 的 讨论 范畴 。 


编写 本 章 内 容 之 初 ， 我 没 料 到 关于 调用 方 信 息 attribute 有 如 此 多 的 内 容 
需要 讨论 。 在 日 癌 工 作 中 ， 我 本 人 很 少 使 用 这 项 特性 ， 但 它 的 设计 层面 
很 值得 我 们 深思 。 从 一 个 很 小 的 特性 入 手 ， 让 我 们 得 以 了 解 设计 团队 背 



































后 付出 的 努力 。 我 们 总 认为 那些 宏大 的 特性 ， 比 如 动态 类 型 、 泛 型 或 
者 async/await 需 要 人 花费 很 大 精力 来 设计 ， 但 是 这 些 不 起 眼 的 小 特性 由 于 
要 和 才 关 有 所 有 可 能 的 极端 情况 ， 同 样 需 要 付出 巨大 的 精力 。 各 个 特性 不 是 
孤立 的 ， 所 以 一 个 新 特性 的 引入 所 市 来 的 潜在 风险 是 ， 未 来 可 能 难以 引 
入 或 者 实现 某 个 新 特性 。 





7.3 ”小结 


foreach 循 环 中 捕获 的 迭代 变量 ， 在 C# 5 中 能 够 发 挥 更 大 的 作用 。 
可 以 使 用 调用 方 信息 attribute 来 让 编译 器 根据 调用 方 所 在 的 文件 、 
行 号 和 成 员 名 来 提供 参数 。 

调用 方 信 息 attribute 展 示 了 语言 设计 工作 中 需要 的 细节 程度 。 


第 三 部 分 C#6 


C# 6 是 我 最 中 意 的 发 行 版 之 一 。 它 包含 了 很 多 特性 ， 不 过 这 些 特性 大 都 
相互 独立 、 易 于 阐述 并 且 易 于 应 用 于 现 有 代码 中 。 虽 然 这 些 特性 学 习 起 
来 有 些 索然 无 味 ， 但 是 它们 能 够 显著 增强 代码 可 读 性 。 如 果 只 能 用 旧版 
本 的 C# 编 写 代 码 ， 那 么 我 会 最 怀念 C# 6 的 特性 。 


C# 6 之 前 的 版 本 都 着 眼 于 引入 全 新 的 思维 模式 〈 泛 型 、LINQ、 动 态 类 
型 以 及 async/await ) ，C# 6 则 侧重 于 打磨 现 有 代码 。 


我 将 这 些 特性 划分 到 了 3 章 : 关于 属性 的 特性 、 关 于 字符 串 的 特性 和 其 
他 特性 。 虽 然 建 议 大 家 按照 顺序 阅读 这 3 章 ， 不 过 它们 并 不 像 LINQ 那 样 
具有 弟 进 的 依赖 天 系 。 


由 于 C# 6 的 特性 易于 应 用 于 现 有 代码 中 ， 因 此 建议 读者 在 学 习 的 同时 动 
手 实践 。 侍 封 许久 的 代码 将 会 是 C# 6 的 一 块 绝 佳 实验 田 。 











第 8 草 极 简 属性 和 表达 式 主体 成 


[| 
内 
本 章 内 容 概览 ， 


。 目 动 实现 只 读 属 性 ; 
。 在 声明 时 初始 化 自动 实现 的 属性 ; 
。 使 用 表达 式 主体 成 员 消 除 见 余 代码 。 


有 些 C# 版 本 会 有 某 个 核心 大 特性 ， 其 他 所 有 新 增 特 性 几乎 都 是 为 它 服务 
的 ， 例 如 C# 3 引入 的 LINQ 和 C# 5 引入 的 异步 特性 。C# 6 则 不 存在 这 样 的 
现象 ， 但 它 也 有 自己 的 主题 ， 那 就 是 几乎 所 有 特性 的 目标 都 是 编写 更 简 
洁 、 更 易 读 的 代码 。C# 6 的 宗旨 不 是 实现 更 多 语言 功能 ， 而 是 用 更 少 的 
代码 实现 相同 的 功能 。 

本 章 要 介绍 的 特性 都 是 关于 属性 这 类 小 规模 代码 的 。 当 代码 量 较 小 时 ， 

即便 移 除 很 少 一 部 分 代码 ， 哪 怕 只 是 插 号 、return 语 句 这 些 ， 效 果 也 是 
十 分 显著 的 。 尽 管 这 些 特性 看 起 来 不 起 眼 ， 但 它们 对 于 实际 代码 的 影响 
相当 大 。 我 们 首先 介绍 属性 ， 随 后 介绍 方法 、 索 引 器 以 及 运算 符 。 


8.1 属性 简 史 

自 C# 诞 生 之 初 ， 属 性 便 存 在 了 。 尽 管 属性 的 核心 功能 一 直 保 持 稳 定 ， 但 

属性 在 源码 中 的 写法 随 着 时 间 的 推移 变 得 日 益 人 简洁 ， 并 且 功 能 渐 趋 多 样 

通过 属性 ， 我 们 可 以 区 分 API 对 外 烘 露 的 状态 访问 和 修改 与 状态 的 
部 实现 。 


例如 要 在 二 维 空间 中 表示 一 个 点 ， 可 以 使 用 两 个 公共 字段 来 表示 扣 的 华 
标 ， 如 下 所 示 。 


代码 清单 8-1 带 有 公共 字段 的 Point 类 


public sealed class Point 


























public double xX; 


public double Y; 





这 种 实现 方式 在 一 看 似乎 没什么 问题 ， 但 这 个 类 的 功能 (“可 以 访问 x 和 
Y 值 ”) 与 实现 方式 (“使 用 两 个 浮 扣 类 型 的 字段 ") 紧 厢 合 了 ， 此 时 实现 
部 分 就 失去 了 上 自 主权。 只 要 类 的 状态 通过 字段 对 外 烘 露 ， 下 面 这 些 操 作 
就 都 无 法 实现 了 。 


。 当 为 字段 赋值 时 ， 无 法 校 验 新 值 〈 比 如 防止 给 X 坐标 和 Y 坐标 赋 无 
穷 小 数 和 非 数 值 ) 。 

当 获 取 字 段 值 时 ， 无 法 执行 计算 《例如 需要 使 用 另外 一 种 格式 存储 
字段 一 一 虽然 对 于 一 个 point 类 型 不 太 可 能 存在 这 种 需求 ， 但 在 茶 

些 场景 中 是 很 有 可 能 的 ) 。 

读者 或 许 认 为 等 到 日 后 需求 及 生变 更 时 ， 完 全 可 以 把 字段 改 成 属性 ， 但 
这 种 修改 属于 破坏 性 修改 ， 应 尽量 避免 。〔 它 破坏 了 源码 、 二 进 制 码 以 
及 反 冉 的 兼容 性 。 不 在 最 初 使 用 属性 ， 是 十 分 冒险 的 。) 

在 C# 1 时 代 ，C# 语 言 几乎 不 文 持 属性 。 代 码 清单 8-1 对 应 的 C# 1 的 属性 


实现 如 下 所 示 。 当 时 需要 手动 声明 字段 ， 为 每 个 属性 声明 getter 方 法 和 
setter 方 法 。 


代码 清单 8-2”C# 1 中 采用 属性 实现 point 类 


public sealed class Point 



































private double x, y; 
public double Xx { get { return x; } set { x 
public double Y { get { return y; } set { y 


value; } } 
value; } } 


了 


可 能 有 人 会 说 : 很 多 属性 最 后 也 不 过 是 实现 对 字段 的 简单 读 写 ， 也 不 需 
要 校 验 、 计 算 等 额外 操作 。 如 有 果 是 此 关 属 性 ， 那 确实 可 以 只 通过 字段 来 
实现 ， 但 我 们 无 法 预知 哪个 属性 将 来 有 可 能 需要 这 些 额 外 操作 。 即 便 我 
们 能 够 准确 预知 未 来 ， 但 这 种 写法 依然 让 人 感觉 游离 于 两 个 抽象 层面 。 
于 我 而 言 ， 属 性 充当 着 类 型 所 提供 协议 的 一 部 分 : 对 外 宣告 自己 的 功 

能 。 字 段 是 实现 的 细节 ， 属 于 黑 盒 的 内 部 机 制 ， 用 户 在 大 部 分 情况 下 不 
需要 了 解 这 部 分 细节 。 我 倾向 于 在 绝 大 部 分 情况 下 把 字段 设置 为 私有 。 


说 明 事 有 例外 ， 在 有 些 情况 下 对 外 直接 暴露 字段 是 合理 行为 。 第 




















11 章 介绍 C# 7 中 的 元 组 特性 时 会 给 出 有 趣 的 示例 。 


C# 2 中 关于 属性 的 改进 仅 一 处 : 允许 getter 和 setter 搭 载 不 同 的 访问 修饰 
符 ， 例 如 public getter 和 private setter。 (这 不 是 仅 有 的 组 合 ， 但 最 常 
见 。) 


C# 3 又 增加 了 上 自动 实现 的 属性 ， 于 是 代码 清单 8-2 就 可 以 改写 成 更 简单 
的 形式 ， 如 下 所 示 。 
代码 清单 8-3 ”使 用 C# 3 实现 的 point 类 和 属性 
public sealed class Point 
public double Xx { get; set; } 


public double Y { get set,; } 
2 


这 种 方式 与 代码 清单 8.2 几 乎 完全 等 价 ， 但 它 不 能 直接 访问 属性 的 对 应 
字段 ， 因 为 这 种 方式 下 的 字段 属于 难 言 之 名 ， 不 是 合法 的 C# 标 识 符 ， 
但 可 以 被 运 云 行 时 识别 。 


而 C# 3 只 允许 上 自动 实现 读 写 属性 。 这 里 不 讨论 只 读 ” 的 优 缺 点 ， 但 很 多 
时 候 确实 需要 让 point 类 具有 不 变性 。 如 果 要 让 属 性 实现 真正 的 只 读 ， 
那么 需要 采用 之 前 的 手动 方式 来 实现 。 


代码 清单 8-4 在 C# 3 中 手动 实现 的 Point 关 的 只 读 属 性 


public sealed class Point 











{ 
private readonly double x, y; <------ 声明 只 读 字 上 段 
public double Xx { get { return x; } } (本 行 及 以 F1 行 ) 声明 只 读 属 + 
public double Y { get { return y; } } 
public Point(double x, double y) 
{ 
this,x = x; (本 行 及 以 下 1 行 ) 在 构造 器 中 初始 化 字段 
this.y = y; 
} 


i 包括 我 在 内 的 很 多 开发 人 员 有 时 会 采取 一 些小 技 
巧 来 规避 ， 束 是 通过 private setter 来 模拟 只 读 属 性 ， 见 代码 清单 8-5。 





Te 





代码 清单 8-5 在 C# 3 中 使 用 private setter 通 过 自动 实现 属性 实现 
Point 类 的 只 读 属性 


public sealed class Point 


public double Xx { get; private set,; } 
public double Y { get; private set,; } 


public Point(double x, double y) 
{ 


Xx, 


x 
Y=Yy; 


} 
} 


这 种 方式 虽然 可 行 ， 但 并 不 令 人 满意 ， 因 为 它 不 能 准确 传达 作者 的 意 

图 。 我 们 的 目的 是 让 该 属性 变 为 只 读 ， 让 属性 只 能 在 构造 器 中 被 赋值 ， 
但 在 Point 类 内 部 还 是 可 以 改变 属性 的 值 。 我 们 需要 一 种 由 字段 支持 的 
更 简单 的 实现 方式 。 一 直到 C# 5， 我 们 都 只 能 在 简单 和 精准 达意 之 间 进 
行 取舍 ， 顾 此 失 彼 。C# 6 终结 了 这 一 困境 ， 终 于 可 以 实现 代码 既 简 单 又 
精准 达意 。 

8.2 自动 实现 属性 的 升级 

C# 6 针对 上 自动 实现 的 属性 引入 了 两 个 新 特性 。 这 两 个 特性 都 简单 易 懂 。 
前 面 关 注 的 主要 问题 是 如 何 用 属性 代 奉 公共 字段 ， 以 及 精准 实现 不 可 变 
类 型 所 遇 到 的 困难 。 下 面 要 介绍 的 C# 6 的 第 一 个 特性 的 用 途 也 不 难 猜 

想 ， 同 时 它 还 移 除 了 一 些 先前 的 限制 条 件 。 

8.2.1 只 读 的 自动 实现 属性 


C# 6 人 允许 以 一 种 简单 的 方式 表达 由 只 读 字 段 文 持 的 真正 只 读 属 性 。 仅 需 
一 个 空 的 getter 方 法 ， 并 不 需要 setter 方 法 ， 如 下 所 示 。 


代码 清单 8-6 ”Point 类 使 用 只 读 自动 实现 属性 


public sealed class Point 






































public double X { get; } (本 行 及 以 下 1 行 ) 声明 只 读 自 动 实现 的 属性 
public double Y { get,; } 


public Point(double x, double y) 
{ 


XxX; (本 行 及 以 下 1 行 ) 在 构造 器 中 初始 化 属性 
yr 








= 
闻 过 
} 
} 


以 上 代码 与 代码 清单 8-5 的 唯一 区 别 就 是 属性 x 和 Y 的 声明 部 分 ， 这 两 个 
属性 完全 噜 除了 setter 方 法 。 在 取消 setter 方 法 之 后 ， 读 者 可 能 会 有 疑 

问 : 在 构造 器 中 该 如 何 初 始 化 属性 ? 初始 化 过 程 和 代码 清单 8-4 手 动 实 
现 的 过 程 完 全 一 致 : 由 自动 实现 属性 所 声明 的 字段 是 只 读 的 ， 任 何 对 局 
性 赋值 的 语句 都 会 被 编译 器 转换 成 对 字段 的 直接 赋值 ， 于 是 除 构造 器 
外 ， 任 何 对 属性 的 赋值 语句 都 会 引发 编译 时 错误 。 


我 个 人 偏好 使 用 字段 只 读 ， 这 一 改进 对 于 我 来 说 意义 重大 。 它 能 够 让 我 
们 仅 用 很 少 的 代码 就 表达 出 理想 的 结果 。 至 少 从 这 一 点 上 说 ， “懒惰 ?不 
再 是 代码 质量 的 绊脚石 。 

C# 6 解除 的 另 一 项 限制 是 关于 初始 化 的 。 前 面 展示 的 代码 要 么 不 进行 显 
式 初 始 化 ， 要 么 在 构造 器 中 完成 初始 化 ， 那 么 如 何 像 对 字段 那样 对 属性 
进行 初始 化 呢 ? 

8.2.2 ”上 自动 实现 属性 的 初始 化 

在 C# 6 之 前 ， 所 有 上 自动 实现 属性 的 初始 化 必须 通过 构造 器 来 完成 ， 我 们 
无 法 在 声明 属性 时 束 对 其 进行 初始 化 。 假 设 在 C# 2 中 有 一 个 Person 类 ， 
如 下 所 示 。 

代码 清单 8-7 在 C#2 中 手动 实现 属性 的 Person 类 


public class Person 












































private List<Person> friends = new List<Person>(); <------ 声 [ 
public List<Person> Friends <------ 读 / 写 属性 字段 通过 属性 对 外 暴露 
{ 


get { return friends; } 
set { friends = Value } 


} 


0 
码 中 现在 还 缺少 显 式 的 构造 器 ， 需 要 继续 修改 代码 ， 见 代码 清单 8-8。 


代码 清单 8-8”C# 3 采用 目 动 实现 属性 的 person 类 


public class Person 





public List<Person> Friends { get; set; } <------ 声明 属性 。 不 儿 


public Person() 





Friends = new List<Person>(); <------ 在 构造 器 中 初始 化 属性 
} 


以 上 代码 和 前 面 的 一 样 元 长 。C# 6 解除 了 这 项 限制 ， 可 以 在 声明 属性 时 
就 完成 初始 化 ， 请 看 代码 清单 8-9。 


代码 清单 8-9 C# 6 自动 实现 读 写 属性 的 Person 类 


public class Person 











public List<Person> Friends { get; set; } = (本 行 及 以 下 1 行 ) 声明 
new LiSst<Person>( ) ; 


当然 ， 它 也 可 以 和 只 读 自动 实现 属性 搭配 使 用 。 一 种 常见 的 模式 是 ， 使 
用 一 个 只 读 属性 ， 然 后 对 外 暴露 一 个 可 变 集合 ， 这 样 调用 方 就 可 以 对 集 
合 执行 添加 或 删除 元 系 的 操作 了， 但 古 不 能 把 力 外 一 个 集合 或 nu11 引 用 
赋值 给 该 属性 。 只 需要 移 除 setter 即 可 。 


代码 清单 8-10 ”C#6 中 Person 类 自动 实现 的 只 读 属性 


public class Person 








public List<Person> Friends { get; } = (本 行 及 以 下 1 行 ) 声明 并 初始 
new List<Person>(); 





} 

尽管 以 前 该 限制 并 不 会 造成 太 大 问题 ， 因 为 通常 需要 通过 构造 器 参数 来 
初始 化 属性 ， 不 过 这 一 改进 也 确实 值得 称道 。 C# 6 解除 的 另 一 项 限制 
如 琳 与 只 读 目 动 实现 属性 连用 更 发挥 作用 











8.2.3 ”结构 体 中 的 自动 实现 属性 


在 C# 6 之 前 ， 我 一 下 对 结构 体 的 自动 实现 属性 心 存 不 满 ， 主 要 有 两 个 原 
因 。 


。 我 所 编写 的 结构 体 基 本 上 是 只 读 的 ， 使 用 目 动 实现 属性 会 很 痛 百 。 
。 根据 “确定 赋值 >? 原则， 一 个 构造 器 的 目 动 实现 属性 的 赋值 ， 只 能 在 
链 式 调用 另 一 个 构造 器 之 后 进行 。 
说 明 一般 而 言 ， 确 定 赋值 原则 指 : 编译 器 会 跟踪 和 记录 代码 执行 
到 特定 位 置 时 (无论 以 何 种 方式 到 达 该 位 置 ) ， 哪 些 变 量 己 经 被 赋 
值 。 该 原则 主要 用 于 约束 局 部 变量 ， 以 保证 访问 茶 个 局 部 变量 时 该 
变量 已 经 梓 赋 值 。 这 里 套用 同样 的 原则 名 称 ， 不 过 作用 稍 有 不 同 。 
代码 清单 8-11 是 point 类 的 结构 体 定 义 ， 它 同时 展示 了 以 上 两 点 问题 。 
单 是 节 出 这 些 代 码 葡 让 我 感觉 浑身 难受 。 
代码 清单 8-11 C#5 Point 结构 体 使 用 自动 实现 属性 


public struct Point 

















public double X { get; private set; } (本 行 及 以 下 1 行 ) public ge 
public double Y { get; private Set; } 














public Point(double x, double y) : this() <------ 链 式 调用 默认 相 
{ 

X = x; (本 行 及 以 下 1 行 ) 属性 初始 化 

Y= y; 
} 


} 

我 不 会 在 实际 代码 库 中 编写 这 样 的 代码 。 这 种 写法 把 目 动 实现 属性 所 带 
来 的 优势 全 部 埋没 了 。 前 面 讨论 了 属性 的 只 读 特 征 ， 是 什么 原因 导致 在 
构造 器 初始 化 右 中 需要 调用 默认 构造 器 呢 ? 

答案 就 隐藏 在 结构 体 字 段 赋值 规则 之 中 。 有 以 下 2 条 规则 。 


。 在 编译 器 确定 结构 体 中 所 有 字段 都 已 经 赋值 之 前 ， 属 性 、 方 法 、 朝 
引 孝 和 事件 都 是 不 可 用 的 。 
。 结构 体 的 构造 圳 在 调用 返回 之 前 必须 确保 所 有 字段 都 已 经 赋值 。 














在 C# 5 中， 如 果 不 调用 默认 的 构造 器 ， 束 同时 违反 了 这 两 条 规则 。 为 x 

和 Y 属 性 赋值 也 被 视 为 对 值 的 使 用 ， 是 不 被 允许 的 。 而 对 属性 赋值 也 不 

被 视 为 对 字段 赋值 ， 因 此 不 能 从 构造 右 返 回 。 先 调用 默认 构造 器 是 一 个 

迁 回 的 解决 办 法 ， 因 为 默认 构造 喜 会 在 当前 构造 器 执 行 开始 之 前 对 所 有 

nn 
性 并 返回 。 


到 了 C# 6， 语 言 和 编译 器 对 目 动 实现 属性 和 属性 对 应 字段 之 间 的 关系 有 
了 新 的 解读 。 
。 人 多 许 在 所 有 字段 赋值 之 前 为 自动 实现 属性 赋值 。 
。 为 目 动 实现 属性 赋值 可 以 视 为 字段 的 初始 化 。 
。 只 要 此 前 目 动 实现 属性 已 经 赋值 ， 那 么 无 论 其 他 字段 是 否 已 经 完成 
初始 化 ， 此 时 都 可 以 读 取 该 属性 。 
可 以 把 这 些 改进 理解 为 : 在 构造 器 中 ， 把 上 自动 实 现 属性 当 作 字段 对 符 。 


有 了 以 上 新 规则 和 真正 的 只 读 上 自动 实现 属性 ， 代 码 清单 8-12 所 示 的 C# 6 
结构 体 版 本 的 Point 就 和 代码 清单 8-6 中 point 类 的 写法 完全 相同 了 ， 当 
然 ， 除 了 声明 关键 字 struct 和 sealed class。 

代码 清单 8-12 ”C# 6 中 Point 结构 体 的 自动 实现 属性 


public struct Point 





























public double Xx { get; } 
public double Y { get; } 


public Point(double x, double y) 
{ 


Xx, 


x 
Y=Yy; 


} 
} 


这 样 的 结果 正 是 我 们 想 要 的 ， 简 洁 义 精准 。 
说 明 读者 可 能 会 质疑 Point 声 明 为 结构 体 的 必要 性 。 在 本 例 中 无 
法 给 出 定论 。pPoint 这 种 数据 结构 感觉 应 该 是 值 类 型 ， 不 过 我 通 间 
还 是 用 类 来 定义 Point。 除 Noda Time 项 目 〈 大 量 使 用 结构 体 ) 外 ， 
我 目 己 很 少 需要 编写 结构 体 。 这 个 例子 并 不 是 主张 多 使 用 结构 体 类 





型 ， 只 是 提醒 当 需 要 使 用 结构 体 时 ，C#i 召 言 能 够 提供 更 好 的 支持 
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前 面 讨论 的 C# 6 特性 都 是 让 目 动 实现 的 属性 更 简洁 ， 通 常 能 够 减少 样板 
代码 ， 但 事实 上 并 不 是 所 有 属性 都 是 自动 实现 属性 。 消 灭 元 余 代码 的 任 
务 并 不 止步 于 此 。 


8.3 ”表达 式 主体 成 员 


其 实 很 难 从 C# 中 找 出 统一 的 编码 风格 。 殷 开 其 他 方面 个 谈 ， 问 题 的 领域 
不 同 ， 实 现 方案 自然 不 同 。 我 在 实际 工作 中 遇 到 过 一 些 类 型 ， 它 们 包含 
大 量 人 简单 方法 和 属性 。 这 种 情况 就 很 适合 使 用 C# 6 提供 的 表达 式 主 体 成 
员 。 前 面 探讨 了 属性 ， 下 面 还 是 以 属性 为 例 展 开 介绍 ， 之 后 逐步 扩展 到 
其 他 函数 成 员 。 


8.3.1 简化 只 读 属 性 的 计算 


有 些 属性 的 规模 比较 小 : 如 果 字 上 段 当前 类 型 的 逻辑 状态 吻合 ， 那 么 属性 
可 以 直接 返回 字段 。 这 就 是 自动 实现 的 属性 发 挥 作用 之 处 。 而 有 的 属性 
还 会 包含 一 些 计 算 ， 计 算 过 程 义 依赖 其 他 字段 或 属性 。 为 了 说 明 该 问 

题 ， 我 们 扩展 前 面 的 point 类 ， 添 加 一 个 新 的 属性 DistanceFromorigin， 
其 作用 是 按照 毕 达 哥 拉 斯 定理 计算 当前 点 与 原点 的 距离 。 


说 明 ”读者 无 须 关 心 所 涉 数学 术语 的 细 市 ， 只 需要 知道 它 是 一 个 使 
用 了 x 和 Y 的 只 读 属性 即 可 。 



































代码 清单 8-13 ”为 Point 类 添加 一 个 DistanceFromorigin 属 性 


public sealed class Point 


public double Xx { get; } 
public double Y { get; } 


public Point(double x, double y) 
{ 


X/ 


X 
Y=Yy; 


} 
public double DistanceFromorigin (本 行 及 以 下 3 行 ) 只 读 属性 ， 用 于 计生 








get { return Math.Sqrt(X * X+Y * Y); } 


} 


这 上 段 代码 的 可 读 性 不 算 太 差 ， 但 确实 有 很 多 形式 代码 。 这 些 代码 的 唯一 
作用 是 让 编译 器 能 够 理解 代码 的 含义 。 图 8-1 是 属性 DistanceFromorigin 
的 图 解 。“ 形 式 代码 ”( 大 括号 、return 语 句 以 及 分 号 ) 用 浅 阴影 标示 。 





图 8-1 标注 了 重点 的 属性 声明 
C# 6 可 将 以 上 声明 大 幅 简 化: 


public double DistanceFromorigin => Math.Sqrt(X* X+Y * Y); 











其 中 的 => 符 号 用 于 指示 表达 式 主体 成 员 ， 在 本 例 中 它 是 一 个 只 读 属 性 。 
这 样 束 移 除 了 大 括号 、 关 键 字 这 些 ， 并 且 之 前 显 式 的 只 读 和 返回 表达 式 
的 部 分 都 隐藏 了 。 和 代码 清单 8-1 相 比 ， 表 达 式 主体 保留 了 所 有 必要 信 
恩 〈 以 一 种 不 同 的 方式 来 表示 只 读 ) ， 省 上 略 了 多 余 信息 ， 堪 称 完美 。 











这 不 是 lambda 表 达 式 


之 前 出 现 过 => 这 个 语法 符号 。lambda 表 达 式 是 C# 3 引入 的 特性 ， 它 
可 以 简化 委托 和 表达 式 树 的 声明 。 例 如 : 


Func<string, int> StringLength = text => text.Length; 


虽然 表达 式 主 体 也 使 用 => 符 号 ， 但 二 者 不 能 混为一谈 。 前 

面 DistanceFromorigin 属 性 的 声明 中 不 涉及 任何 委托 或 表达 式 树 ， 
它 只 是 指引 编译 器 去 创建 一 个 只 读 属性 ， 属 性 根据 给 定 表 达 式 完成 
计算 并 返回 结果 。 


我 一 般 把 这 个 符 写 称 为 “党 第 头 ”。 


读者 可 能 会 质疑 这 一 特性 在 编码 中 的 实际 作用 ， 下 面 以 Noda Time 为 例 
继续 探讨 。 


1. 传递 或 者 代理 属性 
试 考虑 Noda Time 中 的 3 个 类 型 : 


某 个 日 历 中 的 日 期 ， 不 包含 时 间 组 件 ; 
某 天 的 茶 个 时 间 ， 不 包含 日 期 组 件 ; 
日 期 与 时 间 的 组 合 。 


不 考虑 初始 化 这 些 细 市 ， 只 考虑 这 3 个 类 型 所 需 的 要 素 。 显 然 , 日 
期 需要 的 属性 包括 年 、 月 、 日 , 时 间 需 要 的 属性 包括 时 、 分 、 秒 

等 。 那 时 间 与 日 期 的 组 合 需要 什么 呢 ? 虽然 将 日 期 组 件 和 时 间 组 件 
分 开会 比较 方便 ， 但 很 多 时 候 需 要 同时 包含 二 者 。Localpate 组 件 

和 LocalTime 组 件 都 经 了 过 反复 优化 ， 因此 在 LocalpateTime 组 件 中 
最 好 不 要 做 重复 工作 ， 而 是 在 其 中 将 日 期 组 件 和 时 间 组 件 通过 代理 
进行 传递 。 代 码 清单 8-14 所 示 的 实现 十 分 简洁 。 


代码 清单 8-14 Noda Time 中 的 属性 代理 


public struct LocalDateTime 








o LocalDate 
o LocalTime 
o LocalDateTime 














public LocalDate Date { get; } <------ 日 期 组 件 对 应 的 属性 
public int Year => Date,Year， (本 行 及 以 下 2 行 ) 属性 代理 日 期 子 竹 
public int Month => Date.Month ; 

public int Day => Date.Day; 





























public LocalTime TimeOfDay { get; } <------ 时 间 组 件 对 应 的 层 
public int Hour => Time0fDay.Hour; (本 行 及 以 下 2 行 ) 属性 代理 E 
public int Minute => TimeOfDay.Minute,; 
public int Second => TimeOfDay.Second; 


<------ 初始 化 、 其 他 属性 和 成 员 
































} 


移 除 { get { return ... } } 语 句 之 后 ,干净 整 洁 ， 钢 心 悦 目 ， 很 
多 属性 可 以 如 此 操作 。 


. 在 为 一 个 状态 中 执行 简单 逻辑 


在 LocalTime 中 有 一 个 简单 状态 : 当日 的 纳 秒 数 。 其 他 所 有 属性 都 
0 


public int NanosecondofSecond => 
(int) (NanosecondofDay % NodaConstants.NanosecondsPerSeco 


第 10 间 会 介绍 如 何 继续 简化 这 段 代码 ， 目 前 先 感受 表达 式 主体 属性 
带 来 的 简洁 性 即 可 。 

重要 警告 

表达 式 主体 属性 有 一 个 缺陷 : 在 书写 方式 上 ， 一 个 只 读 属 性 与 
一 个 公共 的 可 读 写 属性 只 有 一 个 符号 之 差 。 多 数 情 况 下 如 果 不 
小 心 写 错 ， 编 译 器 就 会 报错 ， 因 为 这 样 做 等 于 在 字段 初始 化 屁 
中 使 用 了 其 他 字段 或 属性 。 对 于 静态 属性 或 者 返回 种 量 的 属 
性 ， 编 译 融 则 不 会 报错 。 考 虑 下 面 两 个 声明 的 差别 : 


// 声明 一 个 只 读 属 性 
public int Foo => 0; 
// 声明 一 个 公共 的 读 / 写 属性 
public int Foo = 0; 


这 种 失误 困扰 过 我 多 次 。 不 过 一 旦 意识 到 有 这 种 出 错 的 可 能 ， 


就 不 难 察 觉 了 。 此 外 ， 还 要 确保 负责 审查 代码 的 同事 也 意识 到 
这 一 点 ， 双 重 保险 更 稳 葡 。 


























关于 表达 式 主体 属性 就 介绍 到 这 里 ， 从 本 节 标 题 可 知 ， 其 他 成 员 也 
可 以 有 表达 式 主体 。 


8.3.2 ”表达 式 主 体 方 法 、 索 引 器 和 运算 符 
除了 表达 式 主体 属性 ， 还 可 以 编写 表达 式 主体 方法 、 只 读 索 引 器 、 运 算 
符 以 及 自 定义 转换 。=> 符 号 的 使 用 方式 是 相同 的 : 没有 由 大 括号 包围 的 
表达 式 以 及 隐 售 的 return 语 句 。 
例如 在 C# 5 中 某 个 point 类 的 Add 方 法 以 及 向 量 加 法 运算 实现 如 下 。 

代码 清单 8-15”C# 5 实现 的 简单 方法 和 运算 符 


public static Point Add(Point left, Vector right) 





























return left + right; <------ 只 代理 运算 符 


public static Point operator+(Point left, Vector right) 





return new Point(left.X + right.X，( 本 行 及 以 下 1 行 ) 简单 构造 器 用 实 ] 
left.Y + right.Y); 
} 


使 用 C# 6 可 以 简化 以 上 代码 ， 二 者 都 可 以 使 用 表达 式 主体 成 员 ， 如 代码 
清单 8-16 所 示 。 

代码 清单 8-16 ”C# 6 中 表达 式 主 体 方法 和 运算 符 
public static Point Add(Point left, Vector right) => left + right 


public static Point operator+(Point left, Vector right) => 
new Point(left.X + right.X, left.Y + right.Y); 


注意 到 在 operator+ 中 使 用 的 格式 了 吗 ? 把 所 有 内 容 放 在 一 行 的 话 ， 代 
码 会 过 长 。 我 一 般 把 => 符 号 放 到 声明 部 分 的 末尾 ， 然 后 将 主体 部 分 缩 
进 。 读 者 当然 可 以 按 自 己 的 编码 习惯 来 操作 ， 不 过 这 种 写法 对 于 所 有 表 
达 式 主体 成 员 都 比较 适用 。 


也 可 以 对 返回 值 为 void 的 方法 使 用 表达 式 主体 。 这 种 情况 没有 return 语 
句 需 要 省 略 ， 只 要 省 略 大 括号 即 可 。 


说 明 这 一 点 也 和 lambda 表 达 式 一 样 。 再 次 提醒 ， 表 达 式 主体 和 
lambda 表 达 式 不 能 混为一谈 ， 它 们 只 是 在 某 些 方面 有 共同 点 而 已 。 


例如 下 面 这 个 简单 的 日 志方 法 : 


public static void Log(string text) 


{ 
} 


可 以 将 其 改写 成 表达 式 主体 方法 。 


public static void Log(string text) => 
Console.writeLine("{0:0}: {1}", DateTime.UtcNow, text); 


虽然 此 处 的 优势 不 太 明 显 ， 但 对 于 一 个 方法 来 说 ， 能 把 方法 声明 和 方法 
体 保持 在 同一 行 ， 还 是 很 不 错 的。 第 9 章 会 介绍 内 插 字 符 串 字面 量 ， 可 
以 将 这 段 代码 进一步 简化 。 


下 面 给 出 关于 方法 、 属 性 和 索引 器 的 最 后 一 个 示例 。 假 设 需 要 创建 并 实 
现 自 己 的 IReadonlyList<T> 来 提供 一 个 基于 IList<T> 的 只 读 视 图 。 当 
多 ReadonlyCollection<T> 已 经 实现 了 相同 的 功能 ， 它 还 实现 了 可 变 接 
口 (IList<T> 和 ICollection<T>) 。 不 过 有 时 需要 通过 接口 来 更 精确 地 
和 
得 很 简短 。 


Console.writeLine("{0:0}: {1}", DateTime.UtcNow, text) 


























代码 清单 8-17 通过 表达 式 主体 成 员 实 现 IReadonlyList<T> 
public sealed class ReadOnlyListView<T> : IReadOonlyList<T> 
private readonly IList<T> list; 
public ReadOnlyListView(IList<T> list) 


this.1list = list,; 























} 
public T this[int index] => list[index]; <------ 索引 器 代理 list 
public int Count => list.Count; <------ 属性 代理 list 属 性 


























public IEnumerator<T> GetEnumerator() => (本 行 及 以 下 1 行 ) 方法 代 焉 
list.GetEnumerator(); 

IEnumerator IEnumerable.GetEnumerator() => (本 行 及 以 下 1 行 ) 方法 人 
GetEnumerator( ) 





} 


其 中 涉及 的 唯一 新 特性 是 表达 式 主体 索引 器 ， 该 特性 的 语法 和 其 他 成 员 
的 相关 语法 很 类 似 。 


人 异常 或 者 出 乎 意料 的 地 方 ? 目前 的 构造 右 看 起 来 还 不 够 优 
| 


8.3.3”C# 6 中 表达 式 主 体 成 员 的 限制 


在 列 出 杀 段 见长 的 代码 之 后 ， 我 通常 会 引出 C# 的 为 一 个 特性 来 优化 代 
码 ， 可 惜 这 条 经 验 对 于 C# 6 来 说 不 再 适用 了 。 


尽管 构造 器 只 包含 一 条 语句 ， 但 C# 6 并 没有 提供 表达 式 主体 的 构造 器 。 
不 能 使 用 表达 陈 主 体 的 成 员 不 仅 限 于 构造 希 ， 还 包括 : 


静态 构造 器 ; 
终结 器 ; 

实例 构造 器 ; 

读 / 写 属性 或 只 写 属性 ; 

读 / 写 索引 器 或 只 写 索 引 器 ; 




















这 些 限制 并 没有 对 我 造成 太 大 影响 ， 不 过 这 种 内 部 不 一 致 性 显然 给 C# 设 
计 团 队 带 来 了 压力 ， 因 此 目 C# 7 起 ， 以 上 成 员 红 可 文 持 表达 式 主 体 。 虽 
说 这 项 特性 并 不 怎么 市 省 字符 ， 但 是 如 果 尊 循 正确 的 格式 规范 ， 可 以 市 
省 一 些 垂直 空间 ， 还 能 增强 可 污 性 ， 因为 它 可 以 传达 “这 是 简单 成 员 ” 的 
含义 。 这 些 成 员 所 使 用 的 语法 我 们 已 经 很 熟悉 了。 代码 清单 8-1 给 出 了 
一 个 完整 示例 ， 旨 在 展示 相关 语法 。 这 段 代 码 仅 用 于 示例 ， 不 可 另 作 他 
人 


代码 清单 8-18 ”C# 7 提供 的 其 他 表达 式 主 体 


public class Demo 

















static Demo() => (本 行 及 以 下 1 行 ) 静态 构造 器 
Console.writeLine("Static constructor called"); 














~Demo() => Console.WriteLine("Finalizer called"); <------ 终结 











private String name; 
private readonly int[] values = new int[10]; 


public Demo(string name) => this.name = name; <------ 构造 器 


private PropertyChangedEventHandler handler; 
public event PropertyChangedEventHandler PropertyChanged (本 行 


add => handler += Value， 
remove => handler -= value; 


} 


public int this[int index] (本 行 及 以 下 4 行 ) 读 / 写 索引 器 
{ 

get => values[index]; 

Set => Values[index] = value; 





} 
public string Name (本 行 及 以 下 4 行 ) 读 / 写 属性 
{ 
get => name; 
set => name = value; 
} 


} 


该 特性 的 一 个 好 处 在 于 : get 访 问 器 和 set 访 问 器 可 以 独立 选择 使 用 表达 
式 主体 ， 互 不 影响 。 假 如 需要 索引 占 的 setter 访 问 器 检查 值 是 否 为 负 ， 可 
以 保持 getter 访 问 器 为 表达 式 主体 形式 : 


public int this[int index] 


{ 
get => values[index]; 
set 
{ 
if (value < 0) 
throw new ArgdumentoOoutofRangeException( ) ; 
Values[index] = value; 
} 
} 








我 认为 类 似 的 需求 将 来 会 很 普 裔 。 根 据 我 的 经 验 ，setter 访 问 器 通常 都 需 
要 校 验 ， 而 getter 访 问 器 通常 功能 都 比较 简单 。 





提示 ”如 果 你 的 getter 访 问 器 中 需要 很 多 逻辑 ， 应 考虑 是 否 需 要 改 
写 为 方法 。 这 两 者 之 间 的 界限 有 时 不 易 确定 。 


表达 式 主体 有 诸多 优点 ， 它 是 否 存在 不 足 之 处 呢 ? 在 把 成 员 都 改写 成 表 
达 式 主体 时 ， 又 该 如 何 拿 捏 分 寸 呢 ? 


8.3.4 ”表达 式 主体 成 员 使 用 指南 


根据 我 的 个 人 经 验 ， 在 运算 符 、 转 换 、 比 较 、 等 价 判断 和 Tostring 方 法 
中 ， 表 达 式 主体 大 有 作为 ， 因 为 相关 代码 通常 比较 简单 。 不 过 凡事 不 能 
一 概 而 论 ， 有 些 类 型 中 可 能 存在 大 量 这 样 的 成 员 ， 它 们 在 代码 可 读 性 上 
可 能 相差 较 大 。 


和 其 他 小 众 特性 不 同 ， 表 达 式 主体 成 员 在 各 代码 库 中 应 用 广泛 。 在 把 
Noda Time 升 级 到 使 用 C# 6 时 ， 我 移 除 了 代码 中 大 概 一 半 return 语 人 句 。 
这 一 变化 影响 巨大 ， 而 且 随 着 逐步 升级 到 C# 7， 情 况 还 会 继续 同好。 


表达 式 主体 成 员 的 优势 不 仅 体 现在 增强 可 读 性 上 ， 它 还 会 对 心理 层面 产 
生 影响 : 使 用 表达 式 主体 成 员 ， 会 让 人 有 一 种 广泛 采用 函数 式 编 程 的 错 
党 。 我 在 此 过 程 中 甚至 感觉 到 了 一 丝 肢 有 球 然 ， 仿 佛 目 己 更 聪 丰 了 了 。 这 上 听 
上 去 虽然 有 反 不 可 思议 ， 但 它 确实 站 合共 种 心理 。 当 然 ， 读 者 可 能 会 更 
冷静 、 更 理智 一 些 。 


一 个 普 衣 存在 的 风险 是 过 度 使 用 新 特性 。 如 果 代 码 中 有 类 似 于 for 循 环 
这 样 的 语句 ， 是 无 法 使 用 表达 式 主体 成 员 的 。 然 而 很 多 时 候 ， 即 便 可 以 
把 芭 个 备 规 廊 法 改写 成 表达 式 主体 成 员 ， 也 个 应 这 样 做 。 例 如 以 下 两 类 


由 : 






































。 执行 条 件 检查 的 成 员 ; 
。 使 用 解释 性 变量 的 成 员 。 


对 于 第 1 类 ， 假 设 有 一 个 Preconditions 类 包含 一 个 泛 型 checkNotNu11 方 
法 ， 访 方法 接收 引用 和 形 参 名 称 。 如 果 引 用 为 nul1， 那 么 根据 形 参 名 称 
抛 出 ArgumentNulL1Exception， 人 否则 返回 该 引用 值 。 这 种 设计 可 以 在 构造 
器 中 将 检查 语句 和 赋值 语句 有 效 结合 起 来 。 


这 样 的 话 ， 方 法 的 执行 结果 既 可 以 用 作 返 回 值 ， 也 可 以 用 于 实 参 。 但 问 
题 在 于 ， 如 果 编 码 不 够 细致 ， 会 导致 代码 表意 不 消 。 下 面 的 方法 来 目 之 





前 提 到 的 LocalDpateTime: 


public ZonedDateTime InZone( 
DateTimeZone zone， 
ZoneLocalMappingResolver resolver) 


{ 
Preconditions.CheckNotNull(zone); 
Preconditions.CheckNotNull(resolver); 
return zone.ResolveLocal(this, resolver); 
} 





这 段 代 码 简单 易 读 : 首先 检查 参数 是 否 合法 ， 然 后 代理 给 另 一 个 方法 。 
下 面 把 它 改 写成 表达 式 主体 : 
public ZonedDateTime InZone( 
DateTimeZone zone， 
ZoneLocalMappingResolver resolver) => 
Preconditions.CheckNotNull(zone) 
.ResolveLocall 
this, 
Preconditions.CheckNotNull(resolver); 


两 段 代码 的 执行 效果 完全 相同 ， 但 后 者 较 不 易 读 。 根 据 我 的 个 人 经 验 ， 
如 采 要 改写 成 表达 式 主 体 ， 那 么 最 多 只 能 有 一 条 检查 语句 ， 人 否则 效 打 不 


佳 。 


对 于 第 2 类 ， 解释 性 的 变量 : NanosecondofSecond 是 LocalTime 的 一 个 属 
性 。LocalTime 中 约 一 半 的 属性 使 用 了 表达 式 主体 ， 但 很 大 一 部 分 属性 
包含 两 条 语句 ， 如 下 所 示 : 


public int Minute 





{ 
get 
{ 
int minuteofDay = (int) NanosecondofDay / NanosecondsPerM 
return minuteofDay % MinuteSPerHour ; 
} 
} 





如 朵 把 两 条 语句 合 为 一 条 《省 略 minuteofpay〉 ， 则 很 容易 改写 成 表达 
式 主体 属性 : 


public int Minute => 
((int) NanosecondofDay / NodaConstants,.NanosecondsPerMinute) ， 


NodaCconstants.MinutesPerHour ; 


这 段 代码 也 实现 了 完全 相同 的 功能 ， 但 第 一 版 中 的 minuteofDay 能 体现 
子 表达 式 的 具体 含义 ， 这 样 整 段 代码 更 易 读 。 


也 许 将 来 我 会 得 出 相反 的 结论， 但 对 于 茶 些 复杂 的 场景 ， 一 步 一 个 脚印 
地 编写 代码 ， 并 且 给 每 步 的 结果 取 一 个 有 意义 的 名 称 ， 竺 半年 之 后 再 回 
头 看 这 些 代码 ， 会 深 感 欣慰 。 另 外 ， 在 调试 的 时 候 ， 这 种 写法 也 便于 逐 
条 语句 地 推进 ， 碍 看 每 一 步 执行 的 结 有 果 是 否 符合 预期 。 


好 消息 是 ， 表 达 式 主体 成 员 是 纯 语 法 糖 ， 我 们 可 以 根据 喜好 随时 把 常规 
代码 改 成 表达 式 主体 ， 也 可 以 把 表达 式 主 体 再 改 回 来 。 


























8.4 小 结 


。 目 动 实现 的 属性 可 以 通过 只 读 字 段 实现 只 读 属 性 。 
0 i 
完成 。 
结构 体 也 可 以 有 自动 实现 的 属性 ， 而 不 必 对 构造 器 进行 链 式 调用 。 
使 用 表达 式 主体 可 以 减少 “形式 代码 ”。 
60 6 
| 。 





第 9 章 子 付 串 特性 
本 章 内 容 概览 


。 末 用 内 插 字 符 串 字面 量 增强 格式 化 代码 的 可 读 性 ; 
。 通过 Formattablestring 实 现 属地 化 和 自 定义 格式 化 ; 
be 使 用 nameof 创 建 利 于 重 构 的 引用 。 


字符 串 的 用 法 已 众所周知 。string 类 型 是 学 习 .NET 数 据 类 型 时 首先 认识 
的 类 型 之 一 。 在 .NET 的 演进 过 程 中 ，string 类 本 里 没有 及 生 太 多 变化 ， 
并 且 自 C#1 问 世 以 来 也 没有 推出 太 多 关于 string 类 型 的 新 特性 。 不 过 C# 
6 打破 了 这 一 沉默 ， 引 入 了 新 的 字符 串 字 面 量 和 运算 符 。 本 章 会 详细 介 
绍 这 两 个 特性 ， 不 过 请 牢记 ， 字 符 串 本 身 并 没有 发 生 任何 变化 。 这 两 个 
特性 都 只 是 获取 字符 串 的 新 方法 ， 仪 此 而 已 。 


与 第 8 革 所 述 特 性 类 似 ， 字 符 串 内 插 特性 没有 提供 任何 新 功能 ， 而 是 让 
我 们 能 以 更 精确 易 读 的 方式 编码 。 这 种 改动 不 可 人 小鹿， 任何 能 便利 代码 
读 写 的 特性 都 有 助 于 提高 生产 效率 。 


nameof 运 算 符 属于 C# 6 提供 的 新 功能 ， 但 它 只 是 一 个 很 小 的 特性 。 它 的 
作用 是 ， 获 取代 码 中 某 个 现 有 的 标识 符 名 称 ， 在 执行 期 以 字符 串 的 形式 
提供 该 名 称 。 昌 然 该 特性 不 像 LINQ 或 async/await 那 样 具 有 其 履 性 ， 但 
它 能 帮助 我 们 规避 拼写 错误 ， 以 及 让 重 构 工 具 发 挥 更 大 价值 。 在 介绍 新 
知识 之 前 ， 首 先 回顾 已 有 知识 。 


9.1 .NET 中 的 字符 串 格 式 化 回顾 

读者 对 这 部 分 内 容 想 必 已 经 了 如 指 掌 了 。 使 用 字符 串 是 C# 开 发 人 员 的 日 
常 工 作 。 一 如 上 既往， 为 了 充分 理解 C# 6 的 字符 串 内 插 特 性 的 工作 原理 ， 
需要 回顾 相关 背景 知识 。 讲 解 新 特性 之 前 ， 首 先 介绍 .NET 如 何 处 理 字符 
串 格式 化 相关 基础 知识 。 

9.1.1 简单 字符 串 格 式 化 

我 个 人 喜欢 编写 一 些小 的 console 应 用 来 测试 新 的 编程 语言 。 这 种 应 用 程 








序 主要 用 于 夯实 基础 、 增 强 信 心 ， 以 便 之 后 精进 技艺 。 像 下 面 这 段 代 
码 ， 我 已 经 熟悉 得 不 能 再 熟悉 了 一 一 询问 用 户 名 称 并 癌 其 问好 。 


Console.write("'What's your name? "); 
string name = Console.ReadLine( ); 
Console.writeLine("Hello, {0}!", name); 


最 后 一 行 代 码 与 本 章 内 容 直 接 相 关 。 它 使 用 了 console.writeLine 的 一 个 
重 载 方法 ， 访 方法 接收 一 个 复合 格式 串 ， 包 括 格式 项 以 及 格式 项 对 应 的 
实 参 。 本 例 中 有 一 个 格式 项 : {9}， 它 会 被 name 变 量 蔡 换 。 大 括号 中 的 
0 (0 表示 第 1 个 值 ，1 表 示 第 2 个 值 ， 以 此 类 
bE 


很 多 API 应 用 了 上 述 模式 。 一 个 典型 的 例子 是 string 类 中 的 Format 方 
法 ， 该 方法 仅 负责 将 字符 串 进行 合理 格式 化 。 接 下 来 增加 示例 的 复杂 


度 。 


9.1.2 使 用 格式 化 字符 串 来 实现 自 定义 格式 化 


解释 一 下 : 这 部 分 内 容 对 我 本 人 和 读者 朋友 都 有 益 。 印 象 中 我 访问 过 
MSDN 页 面 无 数 次 ， 只 为 查找 什么 样 的 格式 应 该 用 在 哪里 ， 以 及 如 何 使 
用 ， 我 经 常 遗 忘 这 类 问题， 0 
忆 ， 希 望 读 者 也 能 从 中 获 益 


复合 格式 串 中 的 每 个 格式 项 都 会 指定 一 个 需要 被 格式 化 的 实 参 的 索引 
值 ， 但 在 格式 化 值 的 时 候 ， 格 式 项 还 可 以 指定 以 下 内 容 。 


。 对 齐 方式 。 对 齐 方式 会 指定 最 小 字 宽 、 左 对 齐 或 右 对 齐 。 右 对 齐 用 
正 值 表 示 ， 左 对 齐 用 负 值 表示 。 

。 格式 化 串 。 格 式 化 串 常 用 于 日 期 /时 间 和 数字 的 表示 。 例 如 按照 
1 可 以 使 用 yyyy-MM-dd 作 为 格式 化 串 。 如 
果 格 式 化 金额 ， 可 以 使 用 c 作 为 格式 化 串 。 格 式 化 串 的 含义 取决 于 
站 和 式 化 和 和 因此 需要 查阅 相关 文档 来 选择 合适 的 格式 化 
































图 9-1 展 示 了 茶 个 价格 所 对 应 的 复合 格式 串 的 各 个 组 成 部 分 


图 9-1 表示 价格 的 复合 格式 串 的 格式 项 


对 齐 方式 和 格式 化 串 是 互相 独立 的 可 选项 。 可 以 指定 任意 一 个 ， 也 可 以 
都 指定 或 都 不 指定 。 逐 号 用 于 指示 对 齐 方式 ， 冒 号 用 于 指示 格式 化 串 。 
格式 化 串 中 也 可 以 出 现 有 逗 号 ， 因 为 对 齐 方式 只 有 一 种 。 

下 面 拓展 图 9-1 的 例子 ， 通 过 不 同 长 度 的 值 对 比 不 同 的 对 齐 方式 。 代 三 
清单 9-1 显 示 了 价格 〈$95.25) 、 小 费 〈$19.05) 和 总 价 〈$114.30) ， 其 
中 标签 左 对 齐 ， 值 右 对 齐 。 


以 US 英语 作为 默认 设置 的 打印 结果 如 下 : 




















Price: $95 .25 
Tip: $19.05 
Total: $114.30 


代码 将 对 齐 值 设 为 9 以 实现 右 对 齐 〈 或 者 换个 说 法 : 左边 用 空格 补 

齐 ) 。 如 果 账 单 金额 很 大 《比如 100 万 美元 ) ， 对 齐 就 不 起 作用 了 ， 因 
为 它 指定 的 是 最 小 字 宽 。 如 果 想 要 让 代码 能 够 右 对 齐 任何 大 小 的 值 ， 则 
需要 先 估计 最 大 值 。 这 样 会 增加 代码 的 复杂 度 ，C# 6 提供 的 新 特性 也 对 
此 无 计 可 施 。 


代码 清单 9-1 将 价格 、 小 费 和 总 价 对 齐 


decimal price = 95.25m; 

decimal tip = price * 0.2m; <------ 小 费 为 价格 的 20% 
Console.writeLine("Price: {0,9:C}", price); 
Console.writeLine("Tip: {0,9:C}", tip); 
Console.writeLine("Total: {0,9:C}", price + tip); 


US 英语 culture 对 代码 清单 9-1 的 结果 有 很 大 影响 。 如 果 是 UK 英语 











culture， 结 果 中 的 现金 符号 会 是 E; 如 果 计 算 机 采用 法 语 culture， 那 么 小 
数 点 分 隔 符 就 会 变 成 逗号 ， 现 金 符 号 会 变 成 欧元 符号 ， 而 且 会 位 于 金额 
的 未 尾 而 不 是 开头 。 这 就 是 做 属地 化 工作 的 乐趣 所 在 ， 下 面 就 来 聊 聊 局 
地 化 。 


9.1.3 ”属地 化 


广义 的 属地 化 指 的 是 那些 让 代码 能 够 为 全 世界 用 户 提供 正确 服务 所 做 的 
工作 。 任 何 宣 称 属 地 化 工作 并 不 复杂 的 人 ， 要 么 经 验 比 我 丰富 ， 要 么 就 
古 经 验 很 少 ， 不 了 解 这 项 工作 有 多 棘手 。 世 界 之 大 ， 无 奇 不 有 ， 总 会 有 
我 们 考虑 不 到 的 极端 情况 。 属 地 化 工作 对 于 所 有 编程 语言 来 说 都 是 难 
题 ， 只 不 过 痛 反 不 同 罢了 。 


说 明 ”这 里 采用 属地 化 这 个 术语 ， 有 些 人 可 能 倾向 于 使 用 国际 化 。 
微软 在 使 用 这 两 个 术语 的 时 候 对 它们 有 所 区 分 ， 不 过 区 别 很 细微 。 
这 里 还 请 专业 人 士 见 这 ， 这 里 不 必 纠 缠 术 语 上 的 细微 差别 ， 而 要 把 
重心 放 在 主要 问题 上 。 


在 .NET 中 ，cultureInfo 是 属地 化 工作 的 一 个 重要 类 型 。 它 负责 某 种 语 
言 〈《 例 如 英语 ) 的 选择 偏好 ， 或 者 特定 地 区 的 语言 〈 比 如 加 拿 大 的 法 

语 ) ， 或 者 某 个 地 区 的 语言 变种 (比如 繁体 中 文 )。 这 些 偏好 还 包括 翻 
译 〈 例 如 一 星期 中 各 天 的 用 词 ) 以 及 指示 文本 排序 规则 和 数字 的 格式 化 
规则 《小数 点 究 况 采用 逗号 还 是 点 号) ， 凡 此 种 种 ， 不 一 而 足 。 


通常 在 方法 签名 中 不 会 直接 出 现 cultureInfo， 而 会 使 

用 IFormatProvider 接 口 ， cultureInfo 实 现 自 该 接口 。 大 部 分 用 于 格式 
化 的 方法 会 有 一 个 重 载 方法 ， 其 中 IFormatProvider 是 重 载 方法 的 首 个 形 
参 ， 其 后 才 是 需要 格式 化 的 字符 串 形 参 。 考 虑 string.Format 的 两 个 方 
法 签名 ， 如 下 所 示 : 


static string Format(IFormatProvider provider, 
string format, params object[] args) 
static string Format(string format, params object[] args) 


如 果 两 个 重 载 方法 只 有 一 个 形 参 不 同 ， 那 么 通常 会 把 该 形 参 放 在 参数 列 
表 的 末尾 。 但 是 对 于 上 面 的 例子 ， 这 样 做 是 行 不 通 的 ， 因 为 args 是 一 个 
形 参 数组 (使 用 parms 修 饰 》。 根 据 规定 ， 当 方法 包含 形 参 数组 时 ， 形 
参数 组 必须 是 最 后 一 个 参数 。 





























虽然 形 参 的 类 型 是 IFormatProvider， 但 传 入 的 实 参 基 本 上 总 
是 cultureInfo。 例 如 按照 US 英语 culture 来 格式 化 我 的 生日 : 1976 年 6 月 
19 日 ， 可 以 写成 : 


var usEnglish = CultureInfo.GetCultureInfo("en-US"); 
var birthDate = new DateTime(1976, 6, 19); 
string formatted = string.Format(usEnglish, "Jon was born on {0:d 


其 中 d 是 短 日 期 格式 的 标准 日 期 /时 间 格 式 ， 在 US 英语 中 对 应 的 是 月 /日 / 
年 ， 我 的 生日 就 会 格式 化 为 6/19/1976; 在 UK 英语 中 ， 则 是 日 /月 /年 ， 于 
是 会 格式 化 为 19/06/1976。 请 注意 ， 二 者 不 仅 顺 序 不 同 ， 在 UK 英语 中 月 
份 还 会 使 用 0 补 齐 到 两 位 数 。 


其 他 一 些 culture 可 能 会 使 用 完全 不 同 的 格式 。 了 解 这 些 不 同 culture 下 不 
同 的 格式 化 结果 也 有 助 于 增长 见识 。 例 如 可 以 尝试 使 用 .NET 支 持 的 所 有 
culture 打 印 同一 日 期 ， 如 代码 清单 9-2 所 示 。 


代码 清单 9-2 使 用 所 有 culture 格 式 化 同一 日 期 


var cultures = CultureInfo.GetCultures(CultureTypes.AllCultures); 
var birthDate = new DateTime(1976, 6, 19); 
foreach (var culture in cultures) 


{ 
string text = string.Format( 
culture, "{0,-15} {1,12:d}", culture.Name, birthDate); 
Console.WriteLine(text); 
} 
结果 如 下 所 示 : 
tg-Cyrl 19.06.1976 
tg-Cyr1-TJ 19.06.1976 
th 19/6/2519 
th-TH 19/6/2519 
ti 19/06/1976 
ti-ER 19/06/1976 
ur -PK 19/06/1976 
UZ 19/06/1976 
UZ-Arab 29/03 1355 
UZ-Arab -AF 29/03 1355 
uz-Cyrl 19/06/1976 


Uz-Cyrl-UZ 19/06/1976 


这 个 例子 还 展示 了 使 用 {9, -15} 来 实现 culture 名 称 左 对 齐 ， 以 及 使 
用 {1,12:d} 实 现 日 期 右 对 齐 。 


1. 根据 默认 culture 格 式 化 


如 果 没 有 指定 format provider， 或 者 给 IFormatProvider 参 数 传 递 了 
null 值 ，cultureInfo.Currentculture 就 会 被 设置 为 默认 值 。 默 认 
值 取 决 于 当前 所 在 上 下 文 ， 可 以 分 别 设置 每 个 线程 的 默认 值 ， 而 有 
些 Web 框 架 会 在 特定 线程 处 理 请 求 之 前 进行 设置 。 


建议 谍 愤 使 用 默认 值 ， 必 须 确保 特定 线程 中 的 值 没有 问题 。 (如 末 
要 路 线程 来 月 动 并 行 操作 ， 那 么 一 定 要 检查 代码 行为 。) 如 果 不 使 
用 默认 值 ， 则 需要 了 解 终端 用 户 所 处 的 culture， 然 后 显 式 地 提供 


culture 信 息 。 


2. 为 机 器 提供 格式 化 


前 面 所 讲 的 格式 化 内 容 都 是 提供 给 终端 用 户 的 ， 但 这 并 不 是 唯一 可 
能 。 对 于 机 器 -机 器 的 通信 《例如 某 个 Web 服务 进行 URL 请 求 的 参 
数 解 析 ) ， 则 需要 invariant culture， 可 以 通过 访问 
cultureInfo.InvariantCulture 静 态 属 性 获取 。 


假设 需要 通过 某 个 web 服务 从 一 个 出 版 商 处 获取 畅销 书 榜 单 。Web 
服务 使 用 https://manning.com/webservices/bestsellers 这 样 的 URL 来 获 
取 ， 该 请 求 可 以 提供 一 个 date 参 数 ， 以 便 获 取 特 定 日 期 的 畅销 书 榜 
单 1。 假 设 请 求 参数 使 用 ISO-8601 标 准 〈 年 -月 -日 ) ， 而 需要 获取 
2017 年 3 月 20 日 的 畅销 书 榜 单 ， 那 么 对 应 的 URL 应 该 是 
https://manning.com/webservices/bestsellers?date=2017-03-20。 然 后 在 
中 让 用 户 选 择 一 个 日 期 ， 之 后 通过 代码 构造 出 URL， 代 码 
0 下 所 示 : 


string url = string.Format( 
CultureInfo.InvariantCulture, 
"{0}?date={1:yyyy-MM-dd}", 
webServiceBaseUrl, 
SearchDate ) ; 





提醒 一 下 ， 多 数 时 候 不 需要 直接 为 机 器 -机 器 的 通信 和 直接 格式 化 数 
据 ， 并 尽量 避免 字符 哩 转 换 。 如 果 使 用 了 字符 串 转 换 ， 往 往 预 示 着 
代码 没有 合理 使 用 库 或 框架 ,或 者 存在 数据 设计 问题 (例如 在 数据 
库 中 用 文本 来 保存 日 期 ， 而 不 是 本 地 的 日 期 /时 间 类 型 》。 话 虽 如 
此 ， 但 经 常 需要 手动 构建 字符 串 ， 此 时 只 要 注意 选择 合适 的 culture 
束 可 以 了 。 


前 面 用 了 很 长 的 篇 幅 来 回顾 字符 串 的 使 用 ， 有 了 这 些 知识 储备 以 及 
这 些 不 其 优雅 的 示例 代码 ， 正 好 适合 开始 学 习 C# 6 的 内 插 字符 串 字 
面 量 o 前 面 展 示 的 那些 st ring. Format 看 起 来 太 过 宛 长 ， 编写 代码 
时 开发 人 员 还 需要 兼 顾 格式 串 和 实 参 这 两 部 分 内 容 ， 芒 神 费力 。 显 
然 ， 代 码 可 以 更 简洁 一 些 。 


1 这 是 一 个 虚构 的 Web 服 务 。 
9.2 ”内 插 字 符 串 字面 量 介绍 


使 用 C# 6 的 内 插 字 符 串 字面 量 ， 能 够 大 幅 简 化 字符 串 格 式 化 工作 。 虽 然 
还 是 同时 需要 格式 串 和 实 参 才能 完成 格式 化 ， 但 使 用 内 插 字 符 串 字面 

量 ， 可 以 把 格式 信息 和 实 参 值 结 合 在 一 起 ， 这 样 写 出 的 代码 更 易 读 。 如 
果 你 的 代码 中 存在 大 量 使 用 string.Format 进 行 硬 编码 的 格式 串 ， 采 用 

内 插 字 符 串 字 面 量 会 有 奇效 。 

字符 串 内 插 不 是 什么 新 概念 ， 在 其 他 编程 语言 中 早已 存在 ， 难 得 的 是 这 
项 特性 和 C# 配 合 得 天 衣 无 颖 。 为 已 经 发 展 成 熟 的 语言 添加 新 特性 是 难 上 
加 难 的 。 

在 探讨 内 插 字符 串 字 面 量 之 前 ， 先 看 几 个 简单 的 例子 。 下 面 介绍 如 何 通 
过 Formattablestring 来 实现 属地 化 ， 然 后 详细 讲解 编译 器 如 何 处 理 内 插 
字符 串 字 面 量 ， 最 后 介绍 该 特性 的 常见 使 用 场景 及 其 局 限 性 。 

9.2.1 简单 内 插 


还 是 以 询问 用 户 名 称 为 例 ， 使 用 C# 6 字符 串 内 插 字 面 量 的 写法 和 先前 版 
本 进行 对 比 。 两 段 代码 整体 上 一 致 ， 只 是 最 后 一 行 有 别 ， 见 表 9-1。 


表 9-1 
































C# 5 的 旧式 格式 化 C# 6 的 内 插 字 符 串 字面 


Console.write("what's your name? 

string name = Console.ReadLine( ); 

Console.writeLine("Hello, {0}!", 
name ) ; 







); Console.write("what's your n 
string name = Console.ReadLi 
Console.WriteLine($"Hello，({ 


内 插 字 符 串 字面 量 部 分 已 加 粗 。 该 语法 以 $ 符 号 开头 ， 位 于 双 引 号 前 。 








编译 圳 可 以 根据 $ 符 号 判断 当前 字符 串 是 内 插 字 符 串 而 不 是 普通 字符 
串 。 新 语法 中 的 格式 项 使 用 {fname} 而 不 是 {6y}。 大 括 吕 内 的 文本 是 一 个 
表达 式 ， 该 表达 式 运 算 后 的 结果 用 于 字符 串 的 格式 人 化。 这样， 格式 化 一 
个 字符 串 所 需 的 所 有 信息 都 已 齐备 ， 因 此 writeLine 中 的 第 2 个 实 参 也 就 
不 再 需要 了 。 


说 明 这 段 代 码 不 能 完全 反映 真实 情况 。 新 版 代码 和 初始 代码 的 工 
作 方 式 并 不 完全 一 致 。 初 始 代码 是 把 所 有 实 参 传递 给 合适 的 
console .WriteLine 重 载 方法 ， 在 重 载 方法 中 执行 格式 化 操作 ;而 新 
版 代码 的 所 有 格式 化 操作 都 是 在 string.Format 调 用 中 完成 的 ， 之 
后 才 调 用 console.writeLine 重 载 方法 ， 该 重 载 方 法 仅 包含 一 

个 string 形 参 ， 不 过 二 者 最 终结 果 是 一 致 的 。 


和 表达 式 主 体 成 员 类 似 ， 这 项 特性 看 起 来 也 不 是 惊天 动 地 的 变化 。 如 果 
只 有 一 个 格式 项 ， 原 始 代码 也 并 没有 太 粳 糕 。 刚 开始 使 用 这 个 新 特性 
时 ， 可 能 需要 花费 较 多 时 间 理 解 新 语法 。 我 最 初 也 对 此 持 怀 疑 态 上 度 。 但 
0 0 
强 。 


看 过 简单 的 例子 之 后 ， 来 看 一 些 稍微 复杂 的 。 和 之 前 的 流程 相同 ， 还 是 
先 了 解 如 何 格 式 化 字符 串 ， 然 后 考虑 属地 化 的 问题 。 


9.2.2 使 用 内 插 字 符 串 字面 量 格式 化 字符 曲 
这 部 分 内 容 没 有 任何 新 知识 。 如 采 要 实现 内 插 方 式 的 对 齐 和 格式 串 ， 那 


和 之 前 普通 的 复合 格式 串 方 式 保持 一 致 即 可 : 在 对 齐 方式 前 使 用 逗号 分 
隅 ， 在 格式 串 前 面 使 用 分 写 。 前 面 复 合格 式 串 的 例子 使 用 内 插 方 式 改写 


























后 很 简单 ， 见 代码 清单 9-3。 
代码 清单 9-3 ”使 用 内 插 字符 串 字 面 量 对 齐 值 
decimal price = 95.25m; 
decimal tip = price * 0.2m; <------ 小 费 为 价格 的 20% 
Console .writeLine($"Price: {price,9:C}"); (本 行 及 以 下 2 行 ) 9 位 整数 右 对 


Console.WriteLine($"Tip: {tip,9:C}"); 
Console.writeLine($"Total: {price + tip,9:C}"); 


请 注意 最 后 一 行 代码 ， 内 插 字 符 串 不 是 只 包含 一 个 实 参 值 ， 它 把 “ 价 
格 ? 和 “小 费 ” 进 行 了 相 加 。 这 个 表达 式 可 以 是 任何 能 够 计算 值 的 表达 式 

(例如 不 能 调用 一 个 void 方 法 ) 。 如 果 该 值 实现 了 IFormattable 接 口 ， 
那么 它 的 Tostring(string，IFormatProvider) 方 法 将 被 调用 ， 否 则 调 
用 System.0bject.ToSstring() 方 法 。 


9.2.3 ”内 插 原 义 字 符 串 字面 量 


读者 之 前 想必 见 过 原 义 字符 串 字 面 量 : 以 @ 符 号 开头 ， 后 跟 双 引 号 。 在 
原 义 字符 串 字 面 量 中 ， 反 和 斜 杠 和 换行 符 会 被 算 作 字 符 串 的 一 部 分 。 例 如 
@"c:\windows" 中 的 反 和 斜 杠 确实 表示 反 冬 杜 ， 它 起 不 到 转 义 字符 的 作 

用 。 原 义 字 符 串 字 面 量 中 仅 有 的 转译 字符 束 是 两 个 双 引 写 ， 结 果 束 是 只 
有 其 中 一 个 双 引 号 会 被 算 作 字符 串 的 一 部 分 。 原 义 字符 串 字 面 量 主要 用 
于 以 下 场景 : 


。 字符 串 由 多 行内 容 组 成 ; 

。 正则 表达 式 “〈 在 正则 表达 式 中 使 用 反 斜 杠 来 进行 转译 ， 这 个 转 义 符 
和 C# 编 译 右 在 普通 字符 串 字 面 量 中 的 转 义 符 不 同 ); 

。 便 编 码 的 Windows 文 件 名 。 


说 明 “对 于 多 行 字符 串 ， 需 要 特别 注意 字符 串 中 最 终 将 包含 哪些 字 
符 。 虽 然 多 数 情况 下 没有 必要 严格 区 分 “ 回 车 和 “ 回 车 换行 "， 但 二 
者 的 区 别 对 于 原 义 字符 串 字面 量 十 分 重要 。 


请 看 如 下 示例 代码 : 


string sql = @" (本 行 及 以 下 3 行 ) SQL 语句 分 割 成 多 行 之 后 易于 阅读 
SELECT City, ZipCode 
FROM Address 
WHERE Country = 'US'",， 



































Regex lettersDotDigits = new Regex(@"[a-z]+\.\d+"); <------ 反 和 斜 杠 
string file = @"c:\users\skeet\Test\Test.cs" <------ Windows 上 的 文 


原 义 字符 串 字面 量 也 可 以 采用 内 插 语 法 : 只 需 像 普通 字符 串 字 面 量 那 
样 ， 将 $ 符 号 置 于 @ 符 号 前 即 可 。 前 面 多 行 输出 的 那个 例子 就 可 以 用 一 个 
内 插 原 义 字 符 串 字面 量 实现 了 ， 如 代码 清单 9-4 所 示 。 


代码 清单 9-4 ”使 用 内 插 原 义 字符 串 字 面 量 对齐 值 


decimal price = 95.25m; 

decimal tip = price * 0.2m; <------ 小 费 为 价格 的 20% 
Console.writeLine($@"Price: {price,9:cC} 

Tip: {tip,9:cC} 

Total: {price + tip,9:C}"); 


我 不 会 这 样 写 代码 ， 因 为 不 如 把 语句 拆 分 开 更 整洁 。 这 段 代 码 仅 用 于 展 
和 
该 用 法 。 


提示 ”$s 和 @ 符 号 的 顺序 很 重要 。s$@"Text" 是 合法 的 内 插 原 义 字符 串 
字面 量 ， 而 @$"Text" 不 是 。 我 个 人 没有 特别 好 的 记忆 方法 ， 大 家 就 
按照 自己 的 方法 编写 ， 如 果 编 译 器 报错 就 调换 顺序 。 


内 插 字 符 串 的 语法 十 分 便捷 ， 但 目前 只 介绍 了 粗浅 的 用 法 。 我 想 大 家 购 
买 本 书 还 是 希望 能 全 面 了 解 新 特性 。 


9.2.4 ”编译 器 对 内 插 字 符 串 字面 量 的 处 理 〈( 第 1 部 分 ) 


编译 絮 对 内 插 字 符 串 字 面 量 做 的 转换 比较 简单 。 它 把 内 插 字 符 串 字面 量 
转换 成 string.Format 方 法 调用 ， 并 且 把 格式 串 中 的 表达 式 抽取 出 来 ， 
作为 string.Format 方 法 调用 的 实 参 放 在 复合 格式 串 之 后 。 原 先 表 达 式 
的 位 置 则 被 蔡 换 成 对 应 的 索引 值 ， 比 如 第 1 个 格式 项 变 成 Toy， 第 2 个 格 
式 项 变 成 Tt}， 以 此 类 推 。 


下 面 举例 说 明 ， 把 格式 化 的 部 分 从 打印 方法 中 剥离 出 来 : 


int x = 10; 
int y = 20; 

string text = $"x={x}, y={y}"; 
Console.writeLine(text); 

















编译 器 对 这 段 代 码 进行 处 理 之 后 ， 就 变 成 了 先前 代码 的 模式 : 
int x 10 ; 

Int y 20 

string text = string.Format("x={0}, y={1}", x, y); 
Console.writeLine(text); 


转换 的 这 部 分 内 容 很 简单 。 如 果 读 者 想 继续 深入 碍 验 ， 可 以 使 用 像 
ildasm 这 样 的 工具 来 得 看 编译 器 生成 的 开 代码 。 


这 种 转换 有 一 个 副作用 ;与 普通 字符 串 字 面 量 或 者 原 义 字符 串 字面 量 不 
同 ， 内 插 字 符 串 字面 量 不 被 视 为 常量 表达 式 。 尺 管 有 些 情况 下 编译 器 可 
以 把 内 插 字 符 串 字面 量 看 作 和 常量 (如 果 它 不 包含 任何 格式 项 或 者 所 有 格 
式 项 都 是 不 含 格 式 捉 或 对 齐 的 字符 串 第 量 ) ， 但 这 些 对 于 语言 来 说 都 只 
是 极端 情况 ， 顾 及 这 些 情况 所 伴随 的 复杂 性 要 咒 于 种 来 的 好 处 。 


规 至 目前 ， 所 有 内 插 字 符 串 都 会 转换 成 string.Format 方 法 调用 ， 但 偶 
尔 也 有 例外 ， 稍 后 继续 讨论 。 





























9.3 ”使 用 Formattablestring 实 现 属地 化 


9.1.3 市 展示 了 字符 串 格 式 化 如 何 利用 不 同 的 format provider〈 特 别 

是 cultureInfo) 来 实现 属地 化 。 前 面 展示 的 内 插 字 符 串 字面 量 都 是 根 
据 当 前 线程 的 默认 culture 来 处 理 的 ， 因 此 9.1.2 节 和 9.2.2 节 中 价格 的 例 
子 ， 在 读者 计算 机 上 的 运行 结果 和 书 中 给 出 的 可 能 不 一 致 。 


为 了 能 在 特定 的 culture 下 执行 格式 化 ， 需 要 以 下 3 点 信息 ; 
， 复 全 格式 惠 ， 震 要 包括 春 编 碍 的 文本 为 值 准备 的 格式 项 占 位 和 
。 格 式 化 所 依据 的 culture。 


可 以 稍微 改写 第 1 个 例子 ， 对 变量 分 别 赋值 ， 最 后 调用 string.Format 方 
法 : 





var compositeFormatString = "Jon was born on {0:d}"; 

var value = new DateTime(1976, 6, 19);，; 

var culture = CultureInfo.GetCultureInfo("en-US"); 

var result = string.Format(culture, compositeFormatString, value) 





对 于 内 插 字 符 串 字面 量 ， 应 该 怎么 做 呢 ? 内 插 字 符 串 字 面 量 包 含 了 前 面 
说 的 前 两 条 信息 (复合 格式 串 和 需要 格式 化 的 值 》， 但 还 没有 位 置 容纳 
culture 信 息 。 稍 后 再 提供 最 后 一 条 信息 也 是 可 以 的 ， 但 目前 看 到 的 所 有 
凡 括 字符 于 字面 部 忆 经 完成 了 格式 化 工作 ， 最 后 返回 的 只 是 一 个 单 
字符 串 。 




















这 时 就 该 Formattablestring 一 显 届 手 了 。 它 是 .NET 4.6 (以 及 .NET 
Core 系 列 的 .NET Standard 1.3) 引入 的 ， 位 于 System 命名 空间 下 。 这 个 
类 的 对 象 能 够 保存 当前 的 复合 格式 串 和 值 的 信息 ， 等 到 获取 culture 信 息 
之 后 ， 就 可 以 利用 最 后 一 条 信息 来 完成 最 终 的 格式 化 了 。 编 译 器 会 在 需 
要 时 识别 出 Formattablestring,， 并 且 把 内 插 字 符 串 字面 量 转换 

成 Formattablestring,， 这 样 就 可 以 把 前 面 生日 的 例子 改写 成 : 


var dateOofBirth = new DateTime(1976, 6, 19); 
FormattableString formattableString = 











$"Jon was born on {dateofBirth:d}"; <------ 在 Formattablestrii 
var culture = CultureInfo.GetCultureInfo("en-US"); 
var result = formattableString.ToString(culture); <------ 在 指定 cu 





了 解 了 使 用 Formattablestring 的 缘由 后 ， 下 面 介 绍 编译 器 是 如 何 使 用 它 
实现 属地 化 的 。 尽 管 属地 化 是 Formattablestring 类 型 的 首要 功能 ， 但 它 
还 可 以 用 于 别处 ，9.3.3 节 将 介绍 。 之 后 还 会 讨论 针对 早期 .NET 
Framework 版 本 的 其 他 实现 方式 。 


9.3.1 编译 器 对 内 插 字 符 串 字面 量 的 处 理 〈( 第 2 部 分 ) 


与 前 面 的 流程 不 同 ， 这 次 先 讨论 编 译 器 如 何 处 理 Formattablestring， 然 
后 详细 介绍 它 的 使 用 方式 。 内 插 字符 串 字面 量 在 编译 时 的 类 型 

是 string。 从 string 到 Formattablestring 或 者 

到 IFormattable (Formattablestring 实 现 的 接口 ) 不 存在 类 型 转换 ， 但 
从 内 插 字 符 串 字面 量 表达 式 到 FormattableSstring 和 IFormattable 存 在 类 
型 转换 。 


表达 式 到 类 型 的 转换 与 类 型 到 类 型 的 转换 ， 其 间 的 差别 是 很 微妙 的 ， 之 
前 其 实 做 过 这 些 转换 。 例 如 整 型 值 5， 其 类 型 是 int， 因 此 如 果 var x = 
5，x 的 类 型 束 是 int。 但 5 也 可 以 用 于 初始 化 一 个 byte 类 型 的 值 ， 比 如 

byte y = 5。 这 人 么 做 是 完全 合法 的 ， 因 为 语言 规范 中 规定 :对 于 常量 整 
型 表达 式 〈 包 括 整 型 字面 量 ) ， 只 要 在 byte 类 型 范围 内 ， 就 存在 从 该 表 
达 式 到 byte 的 隐 式 类 型 转换 。 如 果 理 解 了 这 一 点 ， 就 可 以 对 原 义 字符 串 




















字面 量 应 用 同样 的 方式 。 


当 编译 器 需要 把 内 插 字 符 串 字面 量 转换 成 一 个 FormattableSstring 时 ， 它 
的 执行 步骤 和 转换 到 string 类 型 几乎 相同 ， 差 别 在 于 它 调 用 的 不 

是 string.Format， 而 

是 System.Runtime.CcompilerServices.FormattablestringFactory 中 的 静 


态 create 方 法 。 这 个 类 是 和 Formattablestring 同 期 推出 的 。 回 到 之 前 的 
例子 ， 假 设 有 如 下 代码 : 

int x = 10; 

int y = 20; 

Formattablestring formattable = $"x={x}, y={y}"; 


p00 (当然 ， 需 要 在 正确 的 命 
a 


int x = 10; 

int y = 20; 

FormattableString formattable = FormattabJleStringFactory.Create( 
"x={0}, y={1}", x, y); 


Formattablestring 是 一 个 抽象 类 ， 它 所 包含 的 成 员 如 代码 清单 9-5 所 
人 No 


代码 清单 9-5 ”Formattablestring 类 声明 的 成 员 


public abstract class FormattableSstring : IFormattable 


t 





protected FormattableString( ); 
public abstract object GetArgument(int index); 
public abstract object[] GetArguments(); 
public static string Invariant(FormattableString formattable) 
string IFormattable.ToString 
(string ignored, IFormatProvider formatProvider); 
public override string ToString(); 
public abstract string ToString(IFormatProvider formatProvide 
public abstract int ArgumentCount { get; } 
public abstract string Format { get; } 


. 


了 解 了 Formattablestring 实 例 是 何 时 以 及 如 何 构建 的 ， 下 面 看 看 如 何 应 
用 它 。 


9.3.2 ”在 特定 culture 下 格式 化 一 个 Formattablestring 


目前 而 言 ， 对 于 Formattablestring， 常 见 的 用 法 是 使 用 显 式 指定 的 
culture 下 执行 格式 化 ， 而 不 是 使 用 当前 线程 的 默认 culture。 其 中 大 部 分 
使 用 的 是 invariant culture。 访 culture 很 常用 ， 以 至 于 拥有 自己 的 静态 方 
法 Invariant。 调用 该 静态 方法 等 价 于 把 cultureInfo.InvariantCulture 
传递 给 Tostring(IFormatProvider) 方 法 ， 但 把 Invariant 设 定 为 静态 方 
法 意味 着 它 更 容易 调用 ，9.3.1 市 将 论述 这 种 设计 的 必然 性 。 该 方法 接 
收 Formattablestring 类 型 的 参数 ， 这 就 意味 着 我 们 可 以 使 用 内 插 字 符 串 
字面 量 作 为 实 参 ， 编 译 器 会 应 用 相应 的 类 型 转换 ， 因 此 不 需要 进行 强制 
类 型 转换 或 者 额外 的 变量 了 。 


下 面 举例 说 明 。 假 设 有 一 个 DateTime 类 型 的 值 ， 现 在 需要 把 其 中 的 日 期 
部 分 按照 ISO-8601 标 准 进 行 格式 化 ， 然 后 将 结果 作为 某 个 “机 器 -机 器 ” 通 
信 URE 的 请 求 参 数 。 我 们 使 用 invariant culture 而 不 是 默认 culture 来 避免 
不 可 预知 的 结果 。 


说 明 ”即便 我 们 为 日 期 和 时 间 指 定 了 自 定义 格式 串 ， 而 且 该 自 定 义 
格式 只 包含 数字 ， 最 终结 果 还 是 会 受到 culture 的 影响 。 其 中 最 大 的 
影响 是 ，DateTime 的 值 使 用 当前 culture 默 认 的 日 历 系 统 表示 。 如 果 
要 格式 化 的 日 期 是 2016 年 10 月 21 日 〈 公 历 ) ， 目 标 culture 是 ar- 

SA “沙特 阿拉 伯 的 阿拉 伯 语 ) ， 上 所 得 年 份 会 是 1438 年 。 


有 4 种 方式 可 完成 上 述 格式 化 ， 它 们 都 包含 在 代码 清单 9-6 中 。 这 4 种 方 
式 最 终 得 到 的 结果 是 完全 相同 的 ， 把 它们 放 到 一 起 是 为 了 展示 不 同 的 语 
言 特性 是 如 何 协同 工作 的 。 

代码 清单 9-6 ”在 invariant culture 下 格式 化 日 期 


DateTime date = DateTime.UtcNow; 


























string parameter1 = string.Format( (本 行 及 以 下 2 行 ) 使 用 string.Format 
CultureInfo.InvariantCulture, 
"x={0:yyyy -MM-dd}", 
date ) ; 


string parameter2 = (本 行 及 以 下 2 行 ) 转换 为 Formattab1leString 并 调用 ToSt 
((FormattableString)$"x={date:yyyy-MM-dd}") 
.ToString(CulLtureInfo.InvariantCulture ) ; 


string parameter3 = Formattablestring.Invariant( (本 行 及 以 下 1 行 ) Fo 
$"x={date:yyyy-MM-dd}"); 


string parameter4 = Invariant($"x={date:yyyy-MM-dd}"); <------ Fo 


这 里 parameter2 和 parameter3 的 初始 化 差异 很 有 意思 。 为 了 保证 
parameter2 是 FormattableSstring 关 型 而 个 是 string 关 型 ， 需要 将 内 插 字 
符 串 字面 量 强制 转换 为 该 类 型 。 当然 ， 也 可 以 另外 声明 一 
er 类 型 的 局 部 变量 ， 但 采用 这 种 写法 的 话 ， 代 码 会 比 
较 拖 长 : 与 之 相对 的 是 parameter3 的 初始 化 过 程 ， 它 调 用 了 Invariant 方 
法 ， 该 方法 接收 一 个 Formattablestring 大 类 型 的 参数 。 编 译 右 可 以 据 此 推 
断 出 这 里 应 该 将 内 插 字 符 串 字面 量 隐 式 转换 为 Formattablestring 类 型 ， 
因为 只 有 这 样 才能 保证 方法 调用 是 合法 的 。 


parameter4 中 利用 了 一 还 未 介 绍 的 特性 : 通过 using static 指 令 对 外 
办 全 衣 汪 交 到 下 的 孝 二 方法 读者 可 以 先行 翻阅 到 10.1.1 节 了 解 该 特性 
的 细节 ， 也 可 以 暂 不 理会 ， 相 信 这 里 的 代码 是 没 问 题 的 。 这 里 只 需要 使 


用 using static System.Formattablestring 即 可 。 
在 非 invariant culture 下 完成 格式 化 


如 果 要 在 其 他 culture 下 完成 Formattablestring 的 格式 化 ， 则 需要 调 

用 Tostring 的 某 个 重 载 方法 。 大 部 分 情况 下 ， 直 接 调 

用 Tostring(IFormatProvider) 方 法 即 可 。 请 看 下 面 这 个 简短 的 示例 ， 
在 US 英语 culture 下 通过 “通用 日 期 /时 间 + 短 时 间 ” 标 准 格式 串 〈"g") 格 
式 化 当前 日 期 和 时 间 。 


FormattableString fs = $"The current date and time is: {DateTime. 
string formatted = fs.ToString(CultureInfo.GetCultureInfo("en-US" 


有 时 需要 把 Formattablestring 用 作 参 数 ， 以 完成 最 后 的 格式 化 步骤 ， 这 
时 需要 记得 Formattablestring 实 现 的 接口 是 IFormattable， 因 此 任何 接 
收 IFormattable 参 数 的 方法 都 可 以 接收 Formattablestring 类 型 的 参 

数 。 Formattablestring 实 现 中 的 IFormattable.ToString(string, 
IFormatProvider ) 会 忽略 该 string 参 数 ， 因 为 它 已 经 获得 了 所 需 的 全 部 
言 忌 : 它 使 用 IFormatProvider 参 数 来 调用 Tostring(IFormatProvider) 方 
8 


了 解 了 如 何在 内 插 字 符 串 字面 量 中 使 用 culture， 但 Formattablestring 的 

















其 他 成 员 有 何 作 用 呢 ? 下 面 看 一 个 例子 。 
9.3.3 ”Formattablestring 的 其 他 用 途 


我 认为 除了 9.3.2 节 展示 的 culture，Formattablestring 的 用 途 并 不 广泛 ， 
但 该 类 型 还 有 一 些 功能 值得 了 解 。 接 下 来 的 这 个 例子 从 其 自身 的 角度 来 
讲 优雅 且 直 观 ， 不 过 并 不 推荐 这 种 用 法 ， 因 为 这 段 代 码 不 仅 缺 少校 验 功 
能 以 及 其 他 一 些 特 性 ， 而 且 对 于 那些 不 打算 通读 本 书 的 读者 〈 还 有 静态 
代码 分 析 工 具 ) 来 说 也 是 误导 。 读 者 领会 其 主要 思想 即 可 。 


多 数 开 发 人 员 能 够 意识 到 SQL 注入 攻击 的 风险 ， 很 多 人 也 知道 通用 的 解 
决 方案 是 使 用 参数 化 SQL。 代 码 清单 9-7 是 一 个 反面 案例 。 如 条 用 户 输 
入 的 值 中 包含 撒 号 '， 他 就 能 对 你 的 数据 库 执行 很 多 操作 。 假 设 有 一 个 
数据 库 ， 其 中 的 用 户 ID 可 以 有 tag。 接 下 来 根据 用 户 ID 和 tag 季 选 出 其 中 


的 Description 信 息 。 


代码 清单 9-7 重要 的 问题 说 3 遍 ! 这 段 代 码 不 能 用 ! 这 段 代码 不 能 
用 ! 这 段 代码 不 能 用 ! 


var tag = Console.ReadLine(); <------ 从 用 户 处 读 取 的 任意 数据 
using (var conn = new SqlConnection(connectionString)) 
{ 

conn.Open(); 

string sql = (本 行 及 以 下 2 行 ) 连带 用 户 输入 一 起 动态 构建 SQL 

$Q@"SELECT Description FROM Entries 
WHERE Tag='{tag}' AND UserId={userId}"; 
using (var command = new Sqlcommand(sql, conn)) 











using (var reader = command.ExecuteReader()) <------ 执行 


RE 使 用 获取 的 数据 
} 
3 
} 


我 见 到 的 C# 中 SQL 注 入 风险 多 是 因为 使 用 了 字符 串 拼 接 而 不 是 字符 串 格 
式 化 ， 但 二 者 没有 本 质 区 别 。 它 们 都 是 把 代码 (SQL》〉 和 数据 (用户 输 
入 的 值 ) 进行 混用 ， 这 种 混用 正 是 风险 来 源 。 


这 里 假设 读者 已 经 知道 如 何 使 用 参数 化 SQL 并 且 可 以 正确 调 
用 command,Parameters,Add(.,.) 规 避 SQL 注 入 风险 ; 使 用 参数 化 SQL 实 


现 了 代码 和 数据 的 分 离 ， 警 报 解除 。 然 而 调整 之 后 安全 的 代码 却 不 如 代 
码 清单 9- 7 那么 美观 了 ， 怎 样 才 能 安全 与 美观 兼备 呢 ? 如 何 才能 在 编写 
SQL 语句 时 既 保 证 参数 安全 ， 又 能 清晰 表达 意图 呢 ? 使 

用 Formattablestring 就 能 实现 。 


下 面 偿 是 以 非 安 全 版 本 的 代码 作为 纵 形 进行 改造 。 代 码 清 单 9-8 是 代码 
清单 9-7 改 进 之 后 近乎 安全 的 版 本 。 


代码 清单 9-8 使 用 Formattablestring 实 现 安全 的 SQL 参数 化 


var tag = Console.ReadLine(); <------ 从 用 户 处 读 取 的 任意 数据 
using (var conn = new SqlConnection(connectionString)) 





conn.Open(); 
using (var command = conn.NewSqlCcommand( (本 行 及 以 下 3 行 ) 使 用 内 括 
$Q@"SELECT Description FROM Entries 
WHERE Tag={tag:NVarChar} 
AND UserId={userId:InNt}")) 


using (var reader = command.ExecuteReader()) <------ 站 全 时 


// 使 用 数据 <------ 使 用 结果 





} 


除了 sqlcommand 部 ， 两 个 版 本 其 余 代 码 完 全 相同 。 原 先是 先 通过 内 插 
a 然后 把 字符 串 传 给 sqlcommand 构 造 器 ， 而 改 

进 之 后 是 调用 了 一 个 新 方法 Newsqlcommand。 这 是 一 个 稍 后 将 要 编写 的 

扩展 方法 。 不 难 猿 出 ， 该 方法 的 第 2 个 参数 不 是 string， 而 

是 Formattablestring。 内 插 字 符 串 字面 量 在 {tag} 附 近 没 有 了 单 引号 ， 

而 且 还 指定 了 每 个 参数 的 数据 库 类 型 作为 格式 串 。 这 种 写法 并 不 常见 ， 

那么 其 作用 究竟 是 什么 ? 

首先 猜想 一 下 编译 器 会 做 哪些 工作 。 它 把 内 插 字 符 串 字面 量 拆 分 成 两 部 

和 2 编译 器 构建 出 来 的 复合 格式 
形 如 


SELECT Description FROM Entries 
WHERE Tag={0O0:NVarChar} AND UserId={1:InNt} 


我 们 希望 最 后 的 结果 形 如 : 








SELECT Description FROM Entries 
WHERE Tag=@p© AND UserId=@p1 


很 容易 做 到 : 只 需 把 复合 格式 串 格 式 化 ， 将 计算 结果 为 bpo 和 @p1 的 实 参 
传 入 即 可 。 如 果 这 些 实 参 实 现 了 IFormattable 接 口 ， 调 用 string.Format 
方法 时 会 把 Nvarchar 和 Int 格 式 串 也 传 入 ， 这 样 就 可 以 正确 地 设 定 了 
SqlParameter 的 类 型 了 。 我 们 可 以 自动 生成 那些 名 字 ， 而 且 那 些 值 都 直 
接 来 自 Formattablestring。 


让 IFormattable.Tostring 的 实现 具有 副作用 这 种 做 法 确实 不 太 寻 名， 但 
我 们 可 以 仅 把 该 格式 捕获 的 类 型 用 于 这 一 个 方法 调用 中 ， 把 它 与 其 他 代 
码 安全 地 进行 隅 离 ， 完 整 的 实现 如 下 所 示 。 

代码 清单 9-9 实现 安全 的 SQL 格式 化 


public static class SqlFormattableString 








public static SqlCommand NewSqlCommand( 
this SqlConnection conn,FormattableString formattableStri 


SqlParameter[] sqlParameters = formattableString.GetArgum 

.Select((value, position) => 
new SqlParameter(Invariant($"@p{position}"), valu 

.ToArray( ); 

object[] formatArguments = sqlParameters 
.Select(p => new FormatCapturingParameter(p)) 
.ToArray( ); 

string Sql = string.Format(formattablestring.Format, 
formatArguments ) ; 

var command = new SqlCommand(sql, conn); 

command.Parameters.AddRange(sqlParameters); 

return command ， 


} 
private class FormatCapturingParameter : IFormattable 
{ 

private readonly SqlParameter parameter; 


internal FormatCapturingParameter(SqlParameter parameter) 


this.parameter = parameter; 


} 


public string ToString(string format, IFormatProvider for 


{ 


if (!string.ISNULJLOrEmpty(format ) ) 
{ 
parameter.SqlDbType = (SqlDbType) Enum.Parse( 
typeof (SqlDbType), format, true); 
} 


return parameter. ParameterName ， 


其 中 唯一 的 公共 部 分 就 是 SqlFormattablestring 静 态 类 的 NewSqlcommand 
方法 ， 其 余部 分 都 属于 被 隐藏 的 实现 细节 。 对 于 格式 串 中 的 每 个 占 位 
符 ， 我 们 创建 了 一 个 sqlParameter 和 一 个 对 应 的 
FormatCapturingParameter。 后 者 用 于 把 SQL 中 的 参数 名 格式 化 
为 6pgo、@p1 这 些 。 提 供给 Tostring 方 法 的 值 被 赋 到 了 sqlParameter 中 。 
如 果 用 户 在 格式 串 中 进行 了 指定 ， 也 会 相应 地 设置 参数 的 类 型 。 


开发 人 员 需 要 考虑 是 否 要 产品 代码 中 如 此 发 计 。 我 想 要 实现 一 些 额 
外 的 特性 (比如 在 格式 串 中 包 全 大 小 信 。 在 格式 项 中 不 能 使 用 对 齐 方 
式 ， 因 为 string.Format 会 自行 处 理 ) ， J 肯定 可 以 被 正确 地 产品 
化 ， 但 这 么 做 是 否 小 题 大 做 了 呢 ? 我 们 还 得 中 项 目的 每 个 新 开发 人 员 解 
释 : “代码 着 起 来 有 SQL 注 入 风险 ， 但 实际 上 并 没有 。” 


抛 开 这 个 具体 的 例子 不 谈 ， 在 利用 编译 器 提供 的 数据 抽象 和 和 从 内 插 字符 
串 字 面 量 中 分 离 文本 时 ， 可 能 会 面临 同样 的 选择 困境 。 遇 到 这 类 问题 
时 ， 总 是 需要 思考 : 这 么 做 确实 给 项 目 带 来 了 好 处 ?还 是 仅仅 因为 看 起 
来 比较 高 级 ? 


如 果 目 标 framework 是 .NET 4.6， 那 么 赋 庸 置疑， 但 如 果 必 须 用 一 个 旧版 
本 的 framework 呢 ? 采用 C# 6 编译 器 ， 并 不 意味 着 必须 使 用 新 版 本 的 
framework。 还 好 C# 编 译 器 并 未 限制 该 特性 于 特定 framework 版 本 ， 它 只 
需要 能 够 获取 正确 的 类 型 即 可 。 


9.3.4 在 旧版 本 .NET 中 使 用 Formattablestring 


与 扩展 方法 attribute 和 调用 方 信息 attribute 类 似 ，C# 编 译 器 并 不 限定 哪个 
程序 集 应 当 包 含 GRormattadlestr ing 
FormattablestringFactory 类 型 。 纲 详 器 在 总 的 是 命名 空间 ， 以 及 
FormattableSstringFactory 是 人 否 包含 合适 的 静态 create 方 法 ， 仅 此 而 














己 。 如 果 必 须 使 用 某 个 旧版 本 的 framework 但 又 想 利 
用 Formattablestring， 可 以 自行 实现 该 类 型 。 


在 展示 代码 之 前 ， 必 须 强调 ， 应 当 将 其 视 作 最 后 的 办 法 。 一 旦 目标 
framework 可 以 升级 到 NET 4.6 之 后 的 版 本 ， 束 应 当 立 即 删除 这 些 上 自行 创 
建 的 类 型 ， 以 免 编 译 器 发 出 警告 。 应 当 总 是 避免 出 现 类 似 的 命名 冲突 。 
根据 我 的 经 验 ， 在 不 同 程序 集中 出 现 相 同类 型 可 能 会 导致 难以 诊断 的 问 


题 。 


下 面 看 看 具体 的 实现 代码 ， 其 实 很 简单 。 代 码 清 单 9-10 吉 括 了 两 个 所 需 
的 类 型 。 这 段 代 码 中 省 略 了 逻辑 校 验 ， 简单 起 见 ， 把 FormattableString 
设置 为 具体 类 型 ， 并 把 类 型 设置 为 internal， 不 过 编译 器 并 不 关心 这 些 。 
之 所 以 要 把 类 型 设置 为 internal， 则 在 避免 其 他 程序 集 添加 对 此 实现 的 依 
赖 。 并 不 确定 这 样 做 能 否 刚 好 满足 特定 需求 ， 不 过 读者 在 把 该 类 型 设 为 
public 之 前 请 务必 慎重 考虑 。 
代码 清单 9-10 ”从 零 开 始 实 现 Formattablestring 

using System.Globalization,; 
namespace System.Runtime.CompilerServices 

internal static class FormattableStringFactory 

{ 

internal static FormattableString Create( 


string format, params object[] arguments) => 
new FormattableSstring(format, arguments); 


} 
} 
namespace System 
{ 


internal class FormattableString : IFormattable 


{ 
public string Format { get; } 
private readonly object[] arguments; 


internal FormattableString(string format, object[] argume 


{ 


Format = format; 
this.arguments = arguments; 


public object GetArgument(int index) => arguments[index]; 
public object[] GetArguments() => arguments; 
public int ArgumentCount => arguments.Length,; 
public static string Invariant(FormattableString formatta 
formattable?.ToString(CultureInfo.InvariantCulture); 
public string ToString(IFormatProvider formatProvider) => 
string.Format(formatProvider, Format, arguments); 
public string ToString( 
string ignored, IFormatProvider formatProvider) => 
ToString(formatProvider ); 


} 


关于 以 上 代码 的 具体 细节 ， 不 做 过 多 解释 ， 因 为 每 个 成 员 都 十 分 简单 。 
唯一 可 能 需要 解释 的 就 是 在 Invariant 方 法 中 调 

用 formattable?.ToString(CultureInfo,.InvariantCculture)。 ? .被 称 为 
空 值 条 件 运 算 符 ，10.3 节 会 详 述 。 至 此 ， 了 解 了 内 插 字 符 串 字面 量 的 全 
部 功能 ， 那 么 应 当 如 何 使 用 它 呢 ? 


9.4 使 用 指 丙 和 使 用 限制 


与 表达 式 主体 成 员 类 似 ， 可 以 放心 地 对 内 插 字 符 串 字面 量 进行 试验 。 可 
以 根据 个 人 或 者 团队 的 实际 情况 调整 代码 。 如 果 将 来 想 把 代码 改 回 原 

样 ， 改 动 也 很 简单 。 除 非 在 API 中 使 用 Formattablestring， 人 否则 只 是 内 
插 字 符 串 字面 量 的 话 ， 它 只 是 不 起 眼 的 实现 细节 而 已 。 当 然 ， 也 并 不 是 
说 可 以 宣 无 顾忌 地 随处 使 用 内 插 字 符 串 字面 量 。 下 面 介 绍 内 插 字 符 串 字 
面 量 的 适用 场景 、 不 适用 场景 ， 以 及 哪些 场景 完全 不 能 使 用 。 


9.4.1 适合 开发 人 员 和 机 器 ， 但 可 能 不 适合 最 终 用 户 


好 消息 是 ， 几 乎 所 有 使 用 硬 编码 复合 格式 串 或 者 纯 字符 冲 拼 接 之 处 ， 都 
可 以 使 用 内 插 字 符 串 。 多 数 情况 下 ， 改 进 后 的 代码 更 易 读 。 


这 里 需要 注意 “ 便 编 码 ”。 内 插 字 符 吕 字面 量 不 属于 动态 类 型 。 复 合格 式 
串 存 在 于 源码 之 中 ， 由 编译 器 通过 格式 项 对 其 进行 整合 。 在 预先 知道 文 
本 内 容 和 目标 字符 串 格 式 时 这 是 可 以 接受 的 ， 不 过 不 够 灵活 。 


我 们 按照 用 途 分 类 字符 串 。 束 这 部 分 内 容 来 说 ， 主 要 考虑 以 下 3 种 字符 
申 消 费 者 : 




















。 字符 串 供 其 他 代码 进行 解析 ; 
。 字符 串 用 于 给 其 他 开发 人 员 提 供 信 息 ; 
。 字符 串 用 于 给 最 终 用 户 提 供 信息 。 


下 面 依次 分 析 以 上 3 种 情况 下 斥 插 字符 音字 面 量 的 适用 性 。 
1. 机 器 可 读 的 字符 串 


很 多 代码 需要 读 取 一 些 外 部 字符 串 ， 例 如 机 器 可 读 的 日 志 格 式 、 
URL 请 求 参数 以 及 诸如 XML、JSON 或 YAML 这 些 基于 文本 的 数据 
格式 。 这 些 字 符 串 有 着 各 目的 固定 格式 ， 在 格式 化 时 都 要 使 用 
invariant culture。 这 类 情况 下 ， 当 需要 自己 完成 格式 化 时 ， 特 别 适 
合 使 用 Formattablestring。 提醒 一 下 ， 通常 应 当 直 接 利 用 某 些 现成 
API 所 提供 的 格式 化 功能 来 创建 机 器 可 读 的 字符 串 。 


请 牢记 ， 以 上 这 些 字符 串 可 能 会 租 套 一 些 供 人 阅读 的 字符 串 。 对 于 
日 志文 件 ， 其 中 每 行 的 内 容 可 能 需要 以 特定 方式 格式 化 以 便 可 以 逐 
条 区 分 ， 但 其 中 的 消息 部 分 可 能 是 供 其 他 开发 人 员 碍 阅 的 。 这 时 就 
需要 理 清 楚 代 码 各 部 分 向 套 的 级 别 。 








2. 为 其 他 开发 人 员 提 供 消 恩 


在 大 型 代码 库 中 ， 有 很 多 字符 串 字 面 量 是 供 其 他 开发 人 员 (公司 同 
事 或 者 调用 API 的 外 部 开发 人 员 〉 但 看 的 。 主 要 有 以 下 几 类 。 


o 工具 类 字符 串 ， 例 如 console 应 用 中 的 帮助 消息 。 
o 异常 消息 。 


根据 我 的 经 验 ， 这 些 字 符 串 一 般 是 英文 文本 。 虽 然 包 括 微软 在 内 的 
一 些 公 司 会 把 错误 消息 做 属地 化 处 理 ， 但 大 部 分 公司 不 会 “上 自 找 有 麻 
烦 ”。 属 地 化 工作 无 论 从 内 容 转译 还 是 从 调用 代码 上 讲 ， 代 价 都 极 
其 高 晶 。 如 果 我 们 知道 用 户 至 少 阅读 英文 没有 障碍 ， 尤 其 是 他 们 可 
能 需要 把 这 些 消 息 分 享 到 类 似 于 Stack Overflow 这 样 的 英文 网 站 ， 

对 字符 串 做 属地 化 处 理 束 多 此 一 举 了 。 


是 否 要 深入 到 检查 每 个 值 是 否 痢 在 确定 的 culture 下 完成 了 格式 化 ， 








是 另 一 个 层面 的 问题 。 昌 然 这 么 做 有 助 于 保持 内 部 一 致 性 ， 但 估计 
很 多 开发 人 员 像 我 一 样 并 不 会 在 这 方面 花费 太 多 精力 。 对 于 日 期 ， 
建议 尽量 使 用 没有 歧义 的 统一 格式 。ISO 格 式 的 yyyy-MM-dd 就 清晰 
易 懂 ， 不 会 有 到 底 月 份 在 先 还 是 日 期 在 先 的 争议 (dd/MM/yyyy 还 
是 MM/dd/yyyy) 。 前 面 也 提 到 ，culture 会 影响 日 期 中 具体 的 数字 结 
果 ， 因 为 世界 不 同 地 区 使 用 不 同 的 日 历 系 统 。 因 此 ， 需 要 慎重 考虑 
是 否 采用 invariant culture 强 制 使 用 公历 。 例 如 对 于 某 个 非法 参数 ， 

抛 出 异常 的 代码 如 下 : 


throw new ArgumentException(Invariant( 
$"Start date {start:yyyy-MM-dd} should not be earlier tha 


如 果 预 先知 道 阅 读 这 段 消息 的 开发 人 员 处 于 同一 个 非 英 语 culture， 
就 完全 有 理由 根据 他 们 所 在 的 culture 来 重 写 这 段 消息 。 





. 为 最 终 用 户 提 供 消 忆 


最 后 ， 几 乎 所 有 应 用 程序 都 需要 癌 最 终 用 户 展示 某 些 文本 内 容 。 对 
于 开发 人 员 来 说 ， 我 们 需要 知晓 每 个 用 户 所 需要 的 文本 形式 ， 以 便 
正确 地 回 其 展示 文本 。 有 时 能 够 确定 所 有 用 户 都 可 以 接受 某 个 固定 
culture， 一 般 的 公司 内 部 应 用 程序 ， 或 者 服务 于 同一 地 区 其 他 公司 
的 应 用 程序 都 是 类 似 的 需求 。 这 时 可 能 需要 使 用 某 个 本 地 culture 而 
1 而 且 起 码 可 以 保证 不 同 用 户 看 到 的 信息 是 相同 


上 述 这 些 情况 都 适用 内 插 字 符 串 字 面 量 。 我 个 人 特别 喜欢 把 它 用 于 
异常 消 恕 中 ， 这 样 能 够 精准 编码 ， 还 能 为 需要 查阅 大 量 日 志 来 寻找 
报错 来 源 的 开 太 人 员 提 供 有 用 的 信息 。 


然而 ， 如 果 最 终 用 户 处 于 不 同 的 culture， 内 插 字符 串 字 面 量 就 很 难 
发 挥 作用 了， 而且 如 末 不 做 属地 化 处 理 ， 还 会 有 损 产 品质 量 。 这 种 
情况 下 ， 格 式 串 应 当 配 置 到 资源 文件 ， 而 不 是 出 现在 代码 中 ， 这 样 
也 基本 杜绝 了 使 用 内 插 字 符 串 字面 量 的 可 能 。 当 然 也 会 有 例外 ， 比 
如 在 某 个 HTML 标 签 中 添加 一 小 段 信息 。 此 时 依然 可 以 使 用 内 插 字 
符 串 字面 量 ， 只 不 过 作用 甚 微 。 


对 于 资源 文件 ， 内 插 字 符 串 字面 量 完全 不 适用 ， 下 面 再 看 看 该 特性 















































完全 不 适用 的 几 个 场景 。 
9.4.2 ”关于 内 插 字 符 串 字面 量 的 硬性 限制 


每 个 特性 都 有 局 限 性 ， 内 插 字 符 溃 字面 量 目 然 也 不 例外 。 有 时 可 以 通过 
东 些 打 中 办 法 来 解决 ， 下 面 介 绍 这 些 折 中 方法 ， 建 议 读者 尽量 不 要 一 开 
台 就 采用 这 些 方法 。 


1. 无 法 实现 动态 格式 化 


前 面 讲 过 ， 大 部 分 组 成 内 插 字 符 串 字 面 量 的 复合 格式 串 不 能 更 改 。 
有 一 个 感觉 上 应 该 可 以 动态 表示 但 实际 不 上 能 的 例子 是 独立 格式 
串 。 以 前 面 的 一 段 代码 为 例 : 


Console.writeLine($"Price: {price,9:C}"); 


其 中 对 齐 值 是 9， 是 因为 我 知道 即将 格式 化 的 字符 串 在 9 个 字符 范围 
之 内 。 可 是 假如 需要 格式 化 的 值 大 小 不 确定 怎么 办 ? 那么 最 好 能 让 
9 的 这 部 分 变 成 动态 值 ， 但 并 没有 简单 的 实现 办 法 。 最 可 行 的 方式 
是 使 用 内 插 字符 串 字面 量 作 为 string.Format 的 输入 值 ， 或 者 使 用 
等 价 的 console .writeLine 重 载 方法 ， 如 下 所 示 : 


int alignment = GetAlignmentFromValues(allTheValues); 
Console.writeLine($"Price: {{0,{alignment}:C}}", price); 


首尾 的 两 个 大 括号 变 成 了 双 大 括号 ， 是 因为 使 用 了 字符 串 格 式 化 的 
转 义 机 制 ， 因 为 我 们 需要 内 插 字 符 串 字面 量 的 结果 是 类 似 
于 "price: {9,9}" 这 样 的 字符 串 ， 这 样 才 能 把 price 变 量 填充 到 格式 
项 中 完成 格式 化 ， 然 而 我 并 不 想 编 写 和 阅读 这 样 的 代码 。 
































2. 没有 表达 式 的 重复 计算 


编译 器 对 内 插 字 符 串 字面 量 进行 转换 ， 转 换 后 的 代码 会 立即 执行 格 
式 项 中 的 表达 式 运算 ， 然 后 使 用 结果 构建 string 或 

者 Formattablestring。 这 些 表 达 式 的 运算 不 能 被 延迟 ， 也 不 能 重复 
执行 。 代 码 清单 9-11 看 起 来 可 能 涉及 延迟 执行 ， 但 最 终 两 次 打印 的 
结果 是 同一 个 值 。 











代码 清单 9-11 Formattablestring 也 会 立即 对 表达 式 进 行 运算 





string Value = "Before", 

FormattableString formattable = $"Current value: {value}"; 
Console.WriteLine(formattable); <------ 打印 结果 : "Current valt 
value = "After"; 

Console.WwWriteLine(formattable); <------ 打印 结果 依然 是 : "Current 





也 可 以 大 胆 尝试 一 个 折 中 办 法 。 如 果 让 表达 式 包 含 一 个 lambda 表 达 
式 ， 它 就 可 以 捕获 value 变 量 了 ， 这 样 在 每 次 格式 化 时 会 重新 执行 
表达 式 运 算 。 虽 然 lambda 表 达 式 本 续 会 被 立即 转换 成 委托 ， 但 委托 
会 负责 捕获 value 变 量 〈 而 不 是 当前 值 ) ， 然 后 在 每 次 格式 

化 Formattablestring 时 强制 委托 执行 表达 式 运 算 。 这 绝对 不 是 什么 
好 方法 ， 不 过 随 书 代码 中 还 是 提供 了 相关 示例 。 书 中 不 展示 这 部 分 
代码 ， 以 免 破 坏 整 体 的 和 谐 。 























3. 不 要 出 现 纯 冒 号 


在 内 插 字 符 串 字面 量 中 ， 绝 大 多 数 表 达 式 的 使 用 不 受 限制 ;但 是 如 
果 表 达 式 中 出 现 条 件 运 算 符 ?:， 则 会 造成 C# 语 法 混淆 ， 进 而 影响 编 
译 器 的 工作 。 其 中 的 冒 写 :会 被 当 作 表达 式 和 格式 串 之 间 的 分 隅 符 
处 理 ， 然 后 导致 编译 报错 。 例 如 以 下 代码 非法 : 











Console .writeLine($"Adult? {age >= 18 ? "Yes"” : "No"}"),; 
不 过 ， 可 以 通过 在 表达 式 两 端 添加 小 括号 来 解决 这 个 问题 ; 
Console,WriteLine($"Adult? {(age >= 18 ? "Yes" : "No")}"); 











不 过 这 一 限制 很 少 会 造成 太 大 问题 ， 我 自己 通常 会 控制 好 表达 式 的 
长 度 ， 我 一 般 会 先 把 其 中 的 yes/no 抽 取 到 单独 的 string 变 量 中 。 这 
样 正好 引出 了 接 下 来 要 讨论 的 话题 ， 何 时 才能 上 自由 选择 是 否 使 用 内 
插 字 符 串 字面 量 。 


9.4.3” 何 时 可 以 用 但 不 应 该 用 


对 于 滥用 内 插 字 符 串 字面 量 的 行为 ， 虽 然 编译 器 不 会 发 出 警告 ， 但 你 的 
同事 可 能 会 心 生 怨念 。 不 能 随意 使 用 该 特性 主要 有 以 下 两 个 原因 。 

















1. 推迟 那些 可 能 用 不 到 的 字符 串 的 格式 化 操作 


有 时 需要 将 格式 串 作 为 参数 进行 传递 ， 格 式 化 后 的 实 参 在 方法 中 可 
能 会 用 到 ， 也 可 能 用 不 到 。 假 设 有 一 个 做 条 件 校 验 的 方法 ， 我 们 和 希 
望 把 校 验 条 件 作 为 参数 传 入 ， 此 外 还 需要 传 入 一 个 格式 串 作 为 异常 
信息 的 实 参 ， 于 是 得 到 以 下 代码 : 
Preconditions .CheckArgument ( 

start.Year < 2000, 


Invariant($"Start date {start:yyyy-MM-dd} should not be e 
= 2000.")); 


除 此 以 外 ， 也 可 以 采用 一 个 日 志 框 染 ， 在 运行 时 根据 日 志 级 别 来 记 
录 日 志 。 例 如 可 以 采用 以 下 代码 来 记录 服务 占 收 到 请 求 的 字 市 数 : 


Logger .Debug("Received request with {0} bytes", request.Lengt 
我 们 可 能 会 妨 不 住 把 以 上 代码 改写 成 使 用 内 插 字 符 串 字面 量 : 

Logger .Debug($"Received request with {request.Length} bytes") 
这 么 改写 其 实 很 不 好 。 后 一 种 写法 实际 上 在 方法 调用 之 前 就 已 经 完 


成 了 格式 化 工作 ， 而 不 论 方法 内 部 是 否 使 用 了 格式 化 之 后 的 结果 。 
A 

















读者 可 能 会 问 ， 这 里 能 否 用 Formattablestring 呢 ?如 果 前 面 的 校 验 
方法 或 者 日 志方 法 可 以 接收 Formattablestring 类 型 的 参数 ， 那 么 可 
以 将 格式 化 操作 推 后 ， 并 且 可 以 统一 设置 culture。 不 过 即使 这 样 ， 
依然 会 导致 每 次 创建 新 的 对 象 ， 还 会 造成 不 必要 的 开销 。 


2. 通过 格式 化 增强 可 读 性 


不 使 用 内 插 字 符 串 字面 量 的 第 2 个 原因 是 ， 它 会 使 代码 可 读 性 变 
差 。 短 表达 式 绝对 有 助 于 增强 可 读 性 ， 但 当 表达 式 变 长 之 后 ， 则 需 
要 花费 更 多 时 间 来 区 分 其 中 的 代码 和 文本 。 我 认为 其 中 最 烦人 的 是 
小 括号 。 表 达 陈 中 如 果 包 含 一 些 方法 或 者 构造 右 调 用 ， 就 会 让 人 有 眼 
化 统 乱 。 如 果 文 本 中 也 包含 小 括号 ， 可 读 性 就 更 莹 了 。 


下 面 是 Noda Time 中 的 一 段 真 实 代 码 。 昌 然 这 段 代码 只 是 测试 代 
码 ， 而 不 是 生产 代码 ， 但 代码 可 读 性 依然 不 能 打折 扣 。 


private static string FormatMemberDebugName(MemberInfo m) => 
string.Format("{0}.{1}({2})", 
m.DeclaringType.Name, 
m.Name, 
string.Join(", ", GetParameters(m).Select(p => p.Para 


这 种 写法 不 算 太 差 。 想 象 一 下 把 3 个 实 参 都 放 到 字符 串 中 是 什么 样 
子 : 一 个 长 度 超过 100 的 字符 串 字 面 量 ， 每 个 参数 不 能 像 上 面 这 样 
下 和 直 排 布 ， 最 终 十 分 影响 阅读 体验 。 


最 后 给 出 一 个 极端 例 子 ， 还 记得 首 章 那 个 例子 吗 ”? 


ConSsole.Write("what 's your name? "); 
string name = Console,ReadLine() ， 
Console.writeLine("Hello, {0}!", name); 


我 们 可 以 通过 表达 式 把 以 上 语句 都 填充 到 一 个 内 插 字 符 串 字面 量 
中 。 读 者 可 能 会 有 疑问 ， 内 插 字 符 串 字面 量 只 能 包含 表达 式 ， 而 以 
上 是 3 条 语句 ， 这 该 如 何 实现 呢 ? 答 案 是 利用 lambda 表 达 式 ， 我 们 
需要 把 lambda 表 达 式 转换 成 特定 的 委托 类 型 ， 然 后 调用 该 委托 来 获 
得 结果 ， 这 种 写法 可 行 但 不 优雅 。 有 一 个 优化 的 办 法 ， 如 下 所 示 把 
0 
乏善可陈 。 


Console.writeLine($@"Hello {((Func<string>)(() => 























Console.write("what's your name? "); 
return Console.ReadLine( ); 


}))()}!"); 


强烈 建议 运行 以 上 代码 ， 以 验证 其 可 行 性 ， 然 后 就 把 它 抛 之 脑 后 
吧 。 下 面 介 绍 C# 6 的 男 一 个 与 字符 串 相 关 的 特性 。 


9.5 ”使 用 nameof 访 问 标 识 符 


nameof 运 算 符 本 身 并 不 复杂 : 它 接收 一 个 表达 式 ， 该 表达 式 可 以 是 一 个 
成 员 或 者 一 个 局 部 变量 ， 得 到 的 结果 是 一 个 编译 时 的 常量 字符 串 ， 字 符 














串 内 容 是 该 成 员 或 变量 的 名 字 ， 束 这 么 简单 。 几 是 涉及 对 类 、 属 性 或 方 
法 的 名 称 进 行 便 编 码 时 ， 最 好 用 上 nameof 运 算 符 。 这 样 写 出 的 代码 不 管 
是 现在 还 是 将 来 更 改 时 ， 都 会 更 稳健 。 





9.5.1 nameof 的 第 一 个 例子 


nameof 运 算 符 在 语法 上 接近 typeof 运 算 符 ， 区 别 是 nameof 运 算 符 括号 中 
的 标识 符 不 要 求 必须 是 某 个 类 型 。 代 码 清 单 9-12 列 出 了 若干 成 员 。 


代码 清单 9-12 打印 类 、 方 法 、 字 段 和 参数 的 名 称 
using System ; 
class SimpleNameof 
private string field; 
static void Main(string[] args) 


Console.writeLine(nameof (SimpleNameof )); 
Console.writeLine(nameof (Main)); 
Console.writeLine(nameof (args)); 
Console.writeLine(nameof (field)); 


} 
结果 正如 我 们 所 料 : 


SimpleNameof 
Main 

args 

field 


目前 一 切 都 还 好 ， 可 是 为 什么 不 采用 字符 串 字 面 量 呢 ? 实现 的 效果 相 
同 ， 而 且 代 码 更 简短 。 为 什么 推荐 使 用 nameof 呢 ?一 言 以 蔽 之 : 程序 稳 
健 性 。 我 们 很 难 察觉 字符 串 字 面 量 中 不 慎 出 现 的 拼写 错误 ; 但 如 果 
在 nameof 中 不 小 心 拼 错 了 名 称 ， 束 会 编译 报错 。 


说 明 如果 拼 错 的 名 称 刚 好 与 另 一 个 成 员 的 名 称 相 同 ， 那 么 编译 器 
也 无 能 为 力 了 。 如 果 两 个 成 员 名 称 仅 大 小 写 不 同 ， 比 如 filename 和 
fileName， 这 种 命名 方式 很 容易 造成 编译 器 无 法 识别 而 出 错 ， 因 此 
最 好 避免 。 无 论 是 编译 器 还 是 人 眼 ， 都 很 难 区 分 这 样 的 命名 。 

















编译 器 不 仅 可 以 发 现 拼 写 错 误 ， 还 能 识别 nameof 所 操作 的 成 员 或 者 变 
量 。 如 果 把 这 些 成 员 或 变量 重 命 名 了，nameof 中 的 操作 数 也 会 随 之 改 
变 - 

请 看 代码 清单 9-13， 其 中 oldName 总 共 出 现 了 3 次 : 形 参 声明 、nameof 操 
作 数 以 及 表达 式 。 


代码 清单 9-13 ”一 个 简单 的 方法 : 在 方法 中 使 用 两 次 参数 


static void RenameDemo(string oldName) 


{ 
} 


在 Visual Studio 中 ， 如 果 把 鼠标 指针 放置 在 oldName 出 现 的 任何 一 个 位 置 
a 那么 3 个 oldName 将 同时 被 重 命名 ， 
0 图 9-2 所 示 。 














Console.writeLine($"{nameof(oldName)} = {oldName}"); 





图 9-2 ”在 Visual Studio 中 对 标识 符 进 行 重 命名 


对 于 方法 、 类 型 等 名 称 ， 上 述 操作 也 都 适用 。nameof 运 算 符 对 重 构 友 
好 ， 硬 编码 的 字符 串 字面 量 则 不 然 。 那 么 应 该 何 时 使 用 nameof 运 算 符 
呢 ? 











9.5.2 ”nameof 的 一 般 用 法 


首先 声 明 ，nameof 运 算 符 的 使 用 场景 并 不 仅 限 于 以 下 示例 ， 只 是 这 些 例 
子 比较 常见 。 其 中 大 部 分 发 生 在 C# 6 之 前 ， 要 么 是 硬 编 码 的 名 字 ， 要 人 么 
征 通过 表达 陈 树 来 构建 一 个 重 构 友 好 但 复杂 的 解决 方案 。 


1. 参数 校 验 


第 8 章 展 示 的 Noda Time 中 的 Preconditions.CcheckNotNu1l11 方 法 ， 其 
实 并 不 是 代码 库 中 真实 的 代码 。 真 实 的 代码 还 包含 了 检查 参数 名 称 
oe 从 而 提高 了 方法 的 实用 价值 。 请 看 下 面 的 Inzone 方 
法 : 








public ZonedDateTime InZone( 
DateTimeZone zone， 
ZoneLocalMappingResolver resolver) 


{ 
Preconditions.CheckNotNull(zone, nameof (zone)); 
Preconditions.CheckNotNull(resolver, nameof(resolver)); 
return zone.ResolveLocal(this, resolver); 

} 


其 他 条 件 校 验 的 方法 也 与 之 类 似 ， 这 也 是 到 目前 为 止 我 过 到 的 
nameof 的 最 和 常见 用 法 。 强 烈 建议 读者 在 自己 的 公共 方法 中 做 参数 校 
lt 可 以 实现 更 稳健 的 校 验 ， 并 获得 更 丰富 的 提 
砂 鲁 起 \。 


. 对 计算 得 出 的 属性 设置 属性 变化 通知 


7.2 节 讲 过 ， 使 用 callerMemberNameAttribute， 当 属性 改变 时 ， 

在 INotifyPropertychanged 实 现 中 触发 事件 变 得 更 容易 了。 如 果 一 
个 属性 值 的 变化 会 影响 另 一 个 属性 值 呢 ?假设 有 一 个 Rectangle 
类 ， 该 类 中 有 Height 和 width 两 个 可 读 写 属性 ， 以 及 一 个 只 读 的 Area 
属性 ， 我 们 可 以 为 Area 属 性 添加 事件 触发 ， 还 能 安全 地 提供 属性 名 
称 ， 见 代码 清单 9-14。 


代码 清单 9-14 ”使 用 nameof 来 触发 属性 变更 通知 


public class Rectangle : INotifyPropertyChanged 
{ 














public event PropertyChangedEventHandler PropertyChanged ; 


private double width; 
private double height; 


public double Width 





{ 
get { return width; } 
set 
if (width == value) <------ value 没 有 发 生变 化 时 不 触 4 
{ 


return; 


width = value; 





RaisePropertyChanged()，<------ 为 Width 属 性 触发 事件 
RaisePropertyChanged(nameof (Area)); <------ 为 Are: 





} 
public double Height { ... } <------ 和 Width 属 性 一 样 的 实现 








public double Area => Width * Height; <------ 计算 属性 





private void RaisePropertyChanged( <------ 和 7 .2 节 一 样 的 属 了 
[CallerMemberName] string propertyName = null) { ... 








} 


如 果 使 用 C# 5 来 实现 以 上 代码 ， 大 部 分 内 容 基 本 保持 不 变 ， 除 了 加 
粗 的 那 行 ， 可 能 会 变 成 RaisePropertyCchanged("Area") 或 

者 RaisePropertyChanged(() => Area)。 第 2 种 方式 对 于 
RaisePropertyChanged 来 说 复杂 且 低 效 ， 因为 它 仅仅 为 了 检查 名 称 
惑 需 要 构建 一 棵 表达 式 树 ， 而 采用 nameof 的 方式 则 简单 了 许多 。 


. attribute 


有 时 attribute 可 以 指 代 其 他 成 员 ， 用 于 指示 成 员 之 间 的 关系 。 如 果 

需要 指 代 一 个 类 型 ， 那 么 可 以 使 用 typeof 运 算 符 ， 但 对 于 其 他 成 员 
驶 不 起 作用 了 。 举 一 个 具体 的 例子 : NUnit 可 以 使 

用 TestcaseSource attribute 将 测试 数据 参数 化 ， 这 些 数 据 可 以 来 目 

字段 、 属 性 。 有 了 nameof 运 算 符 ， 就 可 以 用 它 来 安全 地 指 代 所 需 成 
员 了 。 代 码 清 单 9-15 也 是 从 Noda Time 中 截取 的 ， 其 作用 是 测试 所 

有 从 Time Zone Database 〈 不 是 由 IANA 维护 的 TZDB ) 加 载 的 时 区 

在 开始 和 结束 时 间 的 行为 。 


代码 清单 9-15 ”使 用 nameof 运 算 符 来 指定 测试 用 例 


static readonly IEnumerable<DateTimeZone> AllZzones = (本 行 及 以 
DateTimeZoneProviders.Tzdb.GetAllZones( ); 





[Test] 
[TestCaseSource(nameof (AllZones))] <------ 使 用 nameof 指 代 字 段 
public void AllZzonesStartAndEnd(DateTimeZone zone) <------ 测 - 





，<------ 省 略 了 测试 方法 的 主体 代码 


它 的 作用 并 不 仅 限 于 测试 ， 它 对 于 任何 表达 成 员 关 系 的 attribute 都 
适用 。 A dp sl De 这 
样 属 性 之 间 的 关系 就 可 以 通过 attribute 表 示 ， 无 须 额 外 的 代码 了 。 


[DerivedProperty(nameof (Area)) 
public double Width { ... } 


触发 事件 的 方法 可 以 维护 一 个 缓存 的 数据 结构 ， 当 有 通知 到 来 说 
width 属性 发 生变 化 时 ， 它 应 当 为 Area 也 触发 一 个 变更 通 图 知 。 


类 似 地 ， 在 对 象 天 系 映射 技术 (比如 Entity Framework) 中 ， 一 了 1 
类 中 经 常 有 两 个 属性 : 一 个 外 键 ， 一 个 主键 表示 的 实体 ， 示 例如 
下 : 


public class Employee 





[ForeignKey(nameof (Employer))] 

public Guid EmployerId { get; set; } 

public Company Employer { get; set,; } 
} 


其 他 很 多 attribute 目 然 也 可 以 采用 上 述 方式 。 了 解 了 nameof 运 算 符 
的 用 处 后 ， 在 你 现 有 的 代码 库 中 也 许 会 发 现 一 些 能 够 从 中 受益 的 地 
方 ， 尤 其 是 那些 在 编译 时 就 已 经 确定 ， 但 需 要 使 用 反射 才能 获取 的 
名 称 。 出 于 本 章 内 容 的 完整 性 ， 下 面 介 绍 一 些 细 节 。 


9.5.3 ”使 用 nameof 的 技巧 与 陷阱 


这 部 分 所 涉 细节 只 是 针对 某 些 特殊 情况 ， 读 者 可 能 永远 不 会 遇 到 。 总 体 
而 言 ，nameof 很 简单 ， 但 有 些 行为 可 能 让 人 出 平 意料 。 


1. 指 癌 其 他 类 型 的 成 员 


很 多 时 候 需 要 在 一 个 类 于 中 指 代为 一 个 大 环 的 成 员 。 回 到 前 
A 除了 指定 名 称 ， 还 可 以 指定 该 名 称 对 
应 的 类 型 。 如 果 某 个 信息 源 会 被 多 个 测试 引用 ， 最 好 把 它 放 在 某 个 
公共 位 置 。 获取 类 型 名 称 也 可 以 使 用 nameof 来 实现 ; 


[TestCaseSource(typeof(Cultures), nameof(Cultures.AllCultures 




















以 上 代码 等 价 于 如 下 代码 ， 只 不 过 它 缺 少 了 nameof 市 来 的 便利 性 。 


[TestCaseSource(typeof(Cultures), "AllCultures")] 


0 成员 名 称 ， 不 过 仪 限于 实例 成 
。 也 可 以 使 用 类 型 名 来 获取 静态 成 员 和 实例 成 员 的 名 称 。 代 码 清 
单 9.16 列 举 了 所 有 合法 方式 - 


代码 清单 9-16 获取 其 他 类 型 成 员 名 的 所 有 合法 方式 


class OtherClass 


{ 








public static int StaticMember => 3; 
public int InstanceMember => 3; 


} 


class QualifiedNameof 


static void Main() 


{ 
OtherClass instance = null; 
Console.writeLine(nameof(instance.InstanceMember)); 
Console.writeLine(nameof(OtherClass.StaticMember)); 
Console.writeLine(nameof (OtherClass.InstanceMember ) ) ; 
上 


} 


我 个 人 习惯 尽 可 能 都 使 用 类 型 名 ， 因 为 如 果 使 用 变量 来 获取 ， 就 会 

让 人 感觉 与 变量 值 有 关 ， 但 实际 上 变量 只 用 于 在 编译 时 判断 类 型 ， 

人 如 果 是 匿名 类 型 ， 因 为 不 存在 类 型 名 ， 所 以 只 能 
变量 。 


此 外 ， 使 用 nameof 时 ， 成 员 必 须 是 可 访问 的 。 如 果 以 上 代码 中 的 
staticMember 或 者 InstanceMember 是 私有 的 ， 那么 获取 名 称 的 这 部 
分 代码 将 不 能 通过 编译 。 




















这 型 


读者 可 能 会 想 知 道 : 要 获取 一 个 泛 型 类 型 或 方法 的 名 称 会 怎么 样 ? 
会 得 到 什么 吉 果 ? 不 论 是 已 绑 定 的 还 是 未 绑 定 的 类 型 ， 都 可 以 通过 
typeof 运 算 符 获取 。typeof(List<string>) 和 typeof(List<>) 都 是 合 








法 的 ， 并 且 会 得 到 不 同 的 结果 。 


使 用 nameof 时 ， 必 须 指 定 类 型 实 参 ， 但 结果 中 不 会 包含 该 类 型 实 
参 ， 也 不 会 体现 类 型 形 参 的 个 数 : nameof(Action<string>) 和 
nameof (Action<string, string>) 的 结果 都 只 是 Action。 虽然 这 样 
的 设计 可 能 比较 烦人 ， 但 它 确实 可 以 避免 结果 名 称 中 处 理 表 示 数 
组 、 匿 名 类 型 、 髓 套 泛 型 的 及 烦 。 


调用 nameof 时 必须 指定 类 型 实 参 这 样 的 限制 将 来 可 能 会 被 取消 ， 这 
样 就 能 和 typeof 保 持 一 致 ， 也 就 无 须 每 次 都 指定 一 个 对 结果 没有 影 
响 的 类 型 。 不 过 要 让 执行 结果 包含 类 型 实 参 的 个 数 或 者 类 型 实 参 本 
身 的 话 ， 就 属于 破坏 性 更 改 了 ， 不 太 可 能 发 生 。 一 般 推荐 使 

用 typeof 来 获取 Type 信息 。 


也 可 以 在 nameof 运 算 符 中 使 用 类 型 形 参 ， 不 过 与 typeof(T) 不 同 ， 它 
返回 的 是 类 型 形 参 本 身 ， 而 不 是 执行 期 的 类 型 实 参 ， 示 例如 下 : 


static string Method<T>() => nameof(T); <------ 总 是 返回 T 














无 论 以 哪 种 方式 调用 ，Method<Guid>() 或 是 Method<Button>()， 它 
都 只 返回 T。 


. 使 用 别名 


使 用 using 指 令 来 指定 类 型 或 者 命名 空间 别名 ， 通 常 对 于 执行 期 没 
有 任何 有 影响。 别名 只 是 用 于 指 代 相 同类 型 或 命名 空间 的 不 同方 法 而 
已 ， 但 它 并 不 适用 于 nameof 运 算 符 。 例 如 代码 清单 9-17 的 执行 结 
是 GuidAlias， 而 不 是 Guid。 


代码 清单 9-17 在 nameof 运 算 符 中 使 用 别名 


using System; 











using GuidAlias = System.Guid; 
class Test 


static void Main() 


{ 


Console.WriteLine(nameof (GuidAlias)); 


4. 预定 义 别 名 、 数 组 和 可 空 值 类 型 


nameof 运 算 符 不 能 和 预定 义 的 别名 (比如 int、char、 long 等 ) 搭配 
使 用 ， 不 能 和 可 空 值 类 型 (和 带 ? 后 级 的 类 型 ) 搭配 ， 也 不 能 和 数组 
类 型 搭配 ， 因 此 以 下 调用 均 非 法 : 





nameof(float) <------ System,.Single 的 预定 义 别 名 
nameof (Guid?) <------ Nullable<Guid> 的 简写 
nameof (String[]) 数组 <------ 数组 


虽然 这 些 限 制 有 些 不 便 ， 但 是 存在 一 些 折 中 的 办 法 。 例 如 对 于 预定 
义 别名 ， 可 以 使 用 它 的 CLR 类 型 名 ; 而 对 于 可 空 值 类 型 ， 可 以 使 
用 Nullable<T> 来 代替 : 


nameof (Single) 
nameof (Nullable<Guid>) 


前 面 介 绍 泛 型 时 讲 过 ， 对 Nullable<T> 使 用 nameof， 得 到 的 结果 永远 
是 Nullable。 


5. 名 称 ， 简 单 名 称 ， 唯 一 名 称 


在 某 种 程度 上 ，nameof 运 算 符 算是 infoof 运 算 符 的 近亲 ，infoof 是 
一 个 神秘 的 运算 符 ， 只 有 在 C# 语 言 设 计 的 内 部 讨论 会 上 才能 有 幸 见 
到 它 的 踪影 。 如 果 C# 设 计 团 队 能 够 雪 驭 infoof， 我 们 就 可 以 通过 它 
获取 MethodInfo、 EventInfo 以 及 PropertyInfo 等 信息 了 。 然 

而 infoof 十 分 复杂 ， 它 的 很 多 技巧 在 nameof 这 个 简化 版 的 运算 符 上 
并 不 适用 。 无 法 获取 重 载 方法 名 称 呢 ? 没有 关系 ， 重 载 方 法 获取 的 
名 称 都 是 相同 的 。 不 能 分 辩 同 名 称 的 属性 和 类 型 ? 也 没有 关系 ， 因 
为 既然 它们 的 名 字 相 同 ， 也 融 无 所 谓 用 哪 一 个 了 。 虽 然 infoof 的 功 
能 比 nameof 强 大 很 多 ， 但 nameof 更 简单 易 用 ， 足 以 应 对 大 多 数 情 
况 。 














9.6 











关于 nameof 的 返回 值 ， 还 有 一 点 需要 注意 : 是 返回 简单 名 称 还 

是 “末尾 名 称 ”? 在 某 些 不 太 规 范 的 术语 表述 中 ， 如 果 在 一 个 已 经 引 
用 了 system 命 名 空间 的 类 中 ， 使 用 nameof(Guid) 还 

是 nameof(System.Guid) 是 没有 区 别 的 ， 结果 都 是 Guid。 


. 命名 空间 


我 没有 列 出 nameof 可 调用 的 所 有 成 员 ， 因 为 除了 终结 器 和 构造 器 ， 
其 他 成 员 都 文 持 ;但 一 般 说 到 成 员 ， 我 们 想到 的 都 是 类 型 或 者 类 型 
中 的 成 员 ， 很 少 会 想到 命名 空间 。 实 际 上 ， 命 名 空间 也 属于 成 员 : 
命名 空间 是 其 他 命名 空间 的 成 员 。 


但 是 因为 nameof 只 返回 简单 名 称 ， 所 以 该 运算 符 对 于 命名 空间 来 说 
作用 并 不 大 。 例如 nameof(System.Collections.Generic)， 我 们 期 
望 得 到 的 结果 是 system.Ccollections,.Generic， 但 实际 结果 只 

是 Generic。 我 还 从 未 遇 到 过 此 类 应 用 场景 ， 在 编译 时 获取 命名 空 
间 的 名 称 几乎 没什么 价值 。 


小 结 




















使 用 内 插 字 符 串 字 面 量 ， 可 以 以 更 简单 的 方式 格式 化 字符 串 。 

在 内 插 字 符 串 字 面 量 中 依然 可 以 使 用 格式 串 来 提供 更 多 格式 信息 ， 
但 格式 串 必须 是 编译 时 的 已 知 量 。 

A 0 
双重 特性 。 

Formattablest ring 类 型 可 以 在 格式 化 操作 之 前 提供 全 部 的 格式 化 信 


4D Oo 


FormattableSstring 可 以 在 .NET 4.6 和 .NET Standard 1.3 以 外 的 环境 
中 使 用 ; 需要 提供 目 己 实现 的 Formattablest ring 类 型 o 

nameof 运 算 符 提供 了 在 C# 代 码 中 以 重 构 友 好 、 类 型 安全 的 方式 获取 
名 称 的 特性 。 

















第 10 章 简洁 代码 的 特性 “盛宴 >” 
本 章 内 容 概 哆 : 


。 如 何 简化 引用 静态 成 员 的 代码 ; 

。 如 何 更 精准 地 引入 扩展 方法 ; 

。 如 何在 集合 初始 化 右 中 使 用 扩展 方法 ; 
。 如 何在 对 象 初始 化 右 中 使 用 索引 舌 ; 
。 如 何 大 幅 缩减 显 式 空 值 检查 代码 ; 

。 如 何 有 和 针对 性 地 捕获 寞 第 。 


本 章 睹 括 了 大 量 新 特性 ， 但 并 没有 一 个 贯穿 始终 的 主题 ， 而 则 在 以 更 人 简 


练 的 方式 编码 。 这 些 特性 很 难 归 类 到 前 面 的 划 节 ， 因 此 它们 目 成 一 章 ， 
不 过 这 丝 坚 不 影响 它们 的 价值 。 











10.1 using static 指 令 





A 
I\o 


10.1.1 引入 静态 成 员 


关于 该 特性 的 一 个 典型 例子 是 system.Math。System.Math 是 一 个 静态 

类 ， 并 且 只 有 静态 成 员 。 下 面 编写 一 个 将 极 坐 标 〈 角 度 加 距离 ) 转换 为 
直角 坐标 (大 家 熟悉 的 (x, y) 模 型 ) 的 方法 ， 因 为 直角 坐标 系 更 符合 大 众 
的 直观 感受 。 图 10-1 展 示 了 如 何 用 直角 坐标 和 极 坐 标 来 表示 一 个 点 。 如 
果 读 者 对 相关 数学 内 容 不 熟悉 也 没有 关系 ， 代 码 示例 仅 用 于 展示 多 个 静 


en 
态 成 员 。 





图 10-1 极 坐 标 和 直角 坐标 的 例子 
假设 已 经 有 了 一 个 Point 类 型 来 表示 直角 坐标 系 。 转 换 方法 是 一 个 简单 
的 三 角 变 换 。 
。 将 角 从 角度 转换 成 弧度 ， 方 法 是 乘 以 v180。 常 量 r 由 Math.PI 提 供 。 
。 使 用 Math.cos 和 Math.sin 方 法 来 根据 矢量 大 小 计算 x 和 y， 并 相 乘 。 


代码 清单 10-1 是 完整 的 实现 代码 ， 其 中 调用 system.Math 的 部 分 加 粗 了 。 

方便 起 见 ， 省 略 了 类 声明 的 部 分 。 访 方法 可 以 是 coordinateconverter 类 

的 一 部 分 ， 也 可 以 是 Point 类 的 某 个 工厂 方法 。 

代码 清单 10-1 使 用 C#5 实 现 极 坐 标 到 直角 坐标 的 转换 

using System; 

static Point PolarToCartesian(double degrees, double magnitude) 
double radians = degrees * Math.PI / 180; <------ 将 角度 转换 为 红 
return new Point( (本 行 及 以 下 2 行 ) 使 用 三 角 函 数 完 成 转换 


Math.Cos(radians) * magnitude, 
Math.Sin(radians) * magnitude); 


这 段 代 码 的 可 读 性 还 不 算 太 差 ， 不 过 随 着 数学 相关 代码 的 增多 ， 各 种 
Math .的 调用 就 会 充斥 代码 库 了 。 


C# 6 引入 了 using static 指 令 ， 可 简化 以 上 人 代码。 代码 清单 10-2 等 价 于 





代码 清单 10-1， 区 别 在 于 引用 了 system.Math 的 所 有 静态 成 员 。 
代码 清单 10-2 使 用 C# 6 实现 极 坐 标 到 直角 坐标 的 转换 
using static System.Math; 
static Point PolarToCartesian(double degrees, double magnitude) 
double radians = degrees * PI / 180; <------ 将 角度 转换 为 弧度 
return new Point( (本 行 及 以 下 2 行 ) 使 用 三 角 函 数 完成 转换 
Cos(radians) * magnitude, 


Sin(radians) * magnitude); 


让 
如 你 所 见 ，using static 指 令 很 简单 : 
using static _type-name-or-alias ;， 


有 了 该 指 令 之 后 ， 以 下 几 种 成 员 就 都 可 以 通过 名 称 直接 引用 了 ， 无 须 每 
次 使 用 都 带 类 型 名 。 

静态 字段 和 属性 。 

静态 方法 。 

枚 举 值 。 

般 套 类 型 。 

能 够 直接 使 用 枚 举 值 ， 对 于 switch 语 句 和 需要 对 枚 举 值 进行 组 合 的 场景 
都 很 有 用 。 表 10-1 展 示 了 使 用 反射 来 获取 某 个 类 型 的 全 部 字段 的 例子 ， 

比较 了 C# 6 和 C# 5， 其 中 加 粗 的 代码 可 以 通过 using static 指 令 消 除 。 


表 10-1 


C# 5 代码 C# 6 使 用 using static 指 令 


usSing System.Reflection; 








var fields = type.GetFields( using static System.Reflection.Bindi 


BindingFlags.Instance | 
BindingFlags.Static | 
BindingFlags.Public | 


var fields = type.GetFields( 
Instance | Static | Public | Non 


BindingFlags.NonPublic) | 


类 似 地 ， 对 于 利用 switch 语 句 啊 应 特定 HTTP 状 态 的 代码 ， 也 可 以 避免 
在 所 有 case 标 签 中 重复 调用 枚 举 类 型 ， 见 表 10-2。 


表 10-2 


C# 5 代码 C# 6 使 用 using stati 


usSing System.Net,; using static 
System.Net.HttpSta 


switch (response.StatusCode) switch (response.Statu 
{ { 
case HttpStatusCode .OK : case OK: 
case HttpStatusCode.TemporaryRedirect: case TemporaryRedi 
case HttpStatusCode.Redirect: case Redirect: 
case HttpStatusCode.RedirectMethod: case RedirectMetho 
case HttpStatusCode.NotFound: case NotFound: 


default: eraule 





手动 编写 代码 中 一 般 很 少 出 现 舱 套 类 型 ， 不 过 在 生成 的 代码 中 骨 套 类 型 
很 常见 。 在 使 用 钥 套 类 型 时 ， 使 用 C# 6 直接 引用 磐 套 类 型 ， 可 以 大 幅度 
缩减 代码 量 。 下 面 这 段 代 人 码 是 我 在 做 Google Protocol Buffers 序 列 化 库 
时 ， 生 成 的 一 些 用 于 表示 在 原始 .proto 文 件 中 购 套 消息 的 组 套 类 型 。 其 
中 内 骨 的 C# 类 型 设计 为 两 层 散 套 来 避免 命名 冲突 。 假 设 有 原始 的 .proto 
文件 以 及 对 应 的 message 如 下 : 


message Outer { 
message Inner { 
string text = 1; 
} 


Inner inner = 1; 


} 
生成 的 代码 结构 如 下 ， 当 然 ， 还 有 其 他 很 多 成 员 此 处 没有 列 出 。 
public class Outer 
public static class Types 
public class Inner 
public string Text { get; set; } 
} 


public Types.Inner Inner { get; set; } 
} 





C# 5 中 引用 Inner 必 须 通 过 0uter .Types.Inner， 这 种 写法 很 不 美观 ;， 如 
果 使 用 C# 6， 就 会 简单 很 多 ， 只 雷 一 个 using static 即 可 : 


using static Outer.Types; 
Outer outer = new Outer { Inner = new Inner { Text = "Some text h 
通过 using static 引 入 的 成 员 ， 在 进行 成 员 查 找 时 ， 它 们 的 优先 级 要 低 
于 其 他 同名 成 员 。 假 设 引 入 了 system.Math， 而 此 时 类 中 还 声明 了 一 
个 Sin 方 法 ， 那 么 sin() 调 用 的 将 是 自己 声明 的 sin 方法， 而 不 是 Math 中 的 
方法 。 

引入 的 类 型 不 是 必须 为 静态 

using static 中 虽然 有 static， 但 它 并 不 要 求 引 入 的 类 型 必须 是 峙 


态 的 。 虽 然 前 面 的 例子 中 引用 的 类 型 都 是 静态 的 ， 但 如 果 是 普通 类 
型 也 完全 没有 问题 ， 这 样 就 可 以 不 指定 类 型 名 而 访问 其 静态 成 员 
了 了 : 


using static System,String; 


string[] elements = { "a", "b" }; 
Console.WwriteLine(Join(" ", elements)); <------ 使 用 String .Joinf 


string.Join 实 现 的 效果 不 如 前 面 的 例子 明显 ， 但 依然 可 用 ， 而 且 
嵌 套 的 类 型 也 因此 可 以 使 用 简单 名 来 访问 了 。 然 而 有 一 类 静态 成 





员 ， 它 使 用 using static 并 不 直截了当 ， 它 束 是 扩展 方法 。 
10.1.2 using static 与 扩展 方法 


C# 3 有 一 点 我 不 喜欢 一 一 扩展 方法 的 查找 方式 。 使 用 using 指 令 会 同时 
引入 命名 空间 和 扩展 方法 ， 无 法 只 引入 一 个 而 不 引入 男 一 个 。C# 6 针对 
人 


C# 6 中 扩展 方法 和 using static 指 令 之 则 的 关系 很 微妙 。 


。 使 用 using static 指 令 引 入 的 某 个 类 型 的 扩展 方法 ， 不 会 导致 对 应 
命名 空间 下 的 其 他 扩展 方法 被 引入 。 

。 通过 类 型 引入 扩展 方法 ， 不 能 按照 一 般 的 静态 方法 调用 《比如 
Math.Sin) ， 而 是 像 实例 方法 一 样 调用 。 


下 面 以 .NET 中 常用 的 扩展 方法 LINQ 为 例 来 展示 第 1 

Ps System.Linq.Queryable 类 中 包含 了 针对 IQueryable<T> 类 型 的 扩展 
方法 《接收 表达 式 树 作为 参数 ) 。system.Linq.Enumerable 类 中 包含 了 
针对 IEnumerable<T> 类 型 的 扩展 方法 (接收 委托 作为 参数 ) 。 

为 IQueryable<T> 通 过 普通 的 using 指 令 引 入 System,.Linq 实 现 了 继 

了 藉 IEnumerable<T>， 所 以 可 以 直接 在 IQueryable<T> 类 型 上 调用 接收 委托 
的 扩展 方法 ， 不 过 这 并 不 是 我 们 需要 的 。 代 码 清单 10-3 展 示 了 使 

用 using static 指 令 引 入 system.Linq.Queryable， 就 可 以 实现 不 引 

入 System.Linq.Enumerable 的 扩展 方法 。 


代码 清单 10-3 ”有 选择 性 地 引入 扩展 方法 


using static System.Ling.Queryable; 





var query = new[] { "a", "bc", "d" }.AsQueryable(); <------ 创建 一 





Expression<Func<string，bool>> expr = (本 行 及 以 下 2 行 ) 创建 一 个 委托 和 表 
x => x.Length > 1; 
Func<string, bool> del = x => x.Length > 1; 





var valid = query.Where(expr); <------ 合法 : ”使 用 Queryable.Wwhere 
var invalid = query.Where(del); <------ 非法 : 查找 范围 内 不 存在 接受 委托 


有 一 点 需要 注意 : 如 果 不 小 心 使 用 普通 using 指 令 引 入 了 system.Linq， 

















例如 让 query 成 为 显 式 类 型 ， 就 会 在 无 形 中 把 最 后 一 行 变 成 合法 代码 。 


函数 库 的 作者 在 编写 库 时 需要 认真 考量 该 变动 所 带 来 的 影响 。 如 果 需 要 
引入 某 些 扩展 方法 ， 而 且 需 要 允许 用 户 有 选择 地 引入 ， 最 好 使 用 一 个 独 
并 的 命名 空间 。 使 用 C# 6 则 没有 这 一 烦恼 : 可 以 自由 选择 引入 哪些 扩展 
方法 ， 无 须 额外 命名 空间 支持 。 例 如 在 Noda Time 2.0 中 ， 我 引入 了 一 

个 NodaTime .Extensions 的 命名 空间 ， 在 该 命名 空间 下 存在 很 多 类 型 的 扩 
展 方法 。 有 些 用 户 只 需要 其 中 部 分 扩展 方法 ， 因 此 我 只 需 把 这 些 方法 声 
明 分 散 到 了 不 同 的 类 中 ， 在 每 个 类 中 都 只 针对 一 个 类 型 来 扩展 方法 。 有 
0 
前 可 选项 。 


至 于 第 2 点 ， 也 可 以 用 LINQ 来 展示 。 代 码 清单 10-4 对 字符 串 序 列 调 
用 Enumerable.count 方 法 ; 分 别 以 扩展 方法 的 方式 调用 和 以 普通 静态 方 
法 的 方式 调用 。 

代码 清单 10-4 采用 两 种 方式 调用 Enumerable .Ccount 


using System.Collections.Generic,; 
using static System.Ling.Enumerable; 



































IEnumerable<string> strings = new[] { "a", "b", "c" }; 











int valid = strings.Count(); <------ 合法 : 像 调 用 实例 方法 一 样 调用 Count 
int invalid = Count(strings); <------ 非法 : 扩展 方法 与 普通 静态 方法 引入 - 


C# 语 言 倡导 把 扩展 方法 和 其 他 静态 方法 区 别 看 待 。 重 申 一 下 ， 这 一 点 对 
于 库 开 发 者 来 说 会 有 影响 : 将 现 有 的 静态 方法 改造 成 扩展 方法 (在 第 一 
个 参数 前 添加 this 修 饰 符 ，， 以 前 是 非 破坏 性 的 改动 ， 对 于 C# 6 而 言 ， 

就 属于 破坏 性 改动 了 。 在 改 成 扩展 方法 之 后 ， 使 用 using static 指 令 引 
入 方法 的 调用 方 的 代码 不 能 通过 编译 。 


说 明 在 进行 方法 查找 时 ， 通 过 static 引 入 的 扩展 方法 比 通过 命名 
空间 引入 的 扩展 方法 优先 级 低 。 对 于 一 个 非 普 通 方法 调用 来 说 ， 如 
果 有 多 个 从 命名 空间 或 类 引入 的 扩展 方法 同时 满足 调用 ， 则 仍 按 正 
常 的 重 载 决议 执行 。 


对 象 初 始 化 器 和 集合 初始 化 需 也 被 大 规模 地 引入 C# 中 ， 成 了 LINQ 特 性 
的 一 部 分 ， 在 C# 6 中 它们 的 功能 也 增强 了 。 















































10.2 对象 初始 化 融和 集合 初始 化 硕 特 性 增强 


前 情 提 要 : C# 3 引入 了 对 象 初始 化 器 和 集合 初始 化 器 。 对 象 初始 化 器用 
于 在 新 创建 的 对 象 中 设置 属性 (或 者 字段 ，; 集合 初始 化 右 用 于 在 新 创 
建 的 集合 中 添加 元 素 〈 通 过 对 应 类 型 的 Add 方 法 ) 。 下 面 这 段 代 码 展示 
了 使 用 文本 和 背景 色 初 始 化 Windows Forms 的 Button 的 小 例子 ， 其 中 还 
包括 使 用 3 个 值 来 初始 化 一 个 List<int> 的 方式 。 


Button button = new Button { Text = "Go", BackColor = Color.Red } 
List<int> numbers = new List<int> { 5, 10, 20 }; 


C# 6 增强 了 以 上 两 个 特性 ， 提 升 了 二 者 的 灵活 性 。 强 化 后 的 初始 化 器 支 
持 更 多 成 员 ， 对 象 初始 化 器 增加 了 对 索引 器 的 支持 ， 集 合 初始 化 器 增加 
了 对 扩展 方法 的 支持 。 虽 然 这 两 个 特性 不 如 C# 6 的 其 他 特性 应 用 广泛 ， 
但 依然 是 不 错 的 提升 。 


10.2.1 对象 初始 化 器 中 的 索引 器 


在 C# 6 之 前 ， 对 象 初始 化 器 只 能 调用 属性 setter 或 者 直接 为 字段 赋值 。 
C# 6 开始 支持 在 对 象 初始 化 器 中 调用 索引 器 进行 赋值 ， 语 法 和 在 普通 代 
码 中 使 用 [index] = value 相 同 。 


下 面 使 用 stringBuilder 作 为 示例 。 这 个 用 法 很 罕见 ， 不 过 稍 后 会 讲 到 

相关 最 佳 实践 。 这 段 代 码 使 用 字符 串 This text needs truncating 来 初 
始 化 一 个 stringBuilder， 通 过 Length 限 制 builder 的 长 度 ， 并 且 把 最 后 

一 个 字符 修改 为 使 用 Unicode 表 示 的 省 略 写 〈...) 。 在 终端 打印 时 ， 得 
到 的 结果 是 This text...。 在 C# 6 之 前 ， 是 无 法 在 构造 器 中 修改 最 后 一 
个 字符 的 ， 因 此 必须 采用 如 下 方式 实现 : 


string text = "This text needs truncating"; 
StringBuilder builder = new StringBuilder(text) 








Length = 10 <------ 设置 Length 属 性 来 切 分 builder 





builder[9] = '\u2026'; <------ 将 最 后 一 个 字符 修改 为 ..， 
Console.OutputEncoding = Encoding.UTF8; <------ 确保 Console 支 持 Unit 
Console .writeLine(builder); <------ 打印 builder 的 内 容 


虽然 本 例 中 的 初始 化 器 规模 很 小 《只 有 一 个 属性 ) ， 我 会 考虑 再 使 用 一 














条 语句 来 设置 Length 属 性 。 使 用 C# 6， 即 可 在 一 个 表达 式 中 完成 所 有 初 
始 化 工作 ， 因 为 对 象 初始 化 器 文 持 名 引 髓 了 ， 见 代码 清单 10-5。 


代码 清单 10-5 在 StringBuilder 的 对 象 初始 化 器 中 使 用 索引 器 








string text = "This text needs truncating"; 
StringBuilder builder = new StringBuilder(text) 
{ 
Length = 10, <------ 设置 Length 属 性 来 切 分 builder 
[9] = '\u2026' <------ 将 最 后 一 个 字符 修改 为 ,, ， 
}; 
Console,OutputEncoding = Encoding.UTF8; <------ 确保 Console 支 持 Unit 
Console .WriteLine(builder); <------ 打印 builder 的 内 容 


其 中 特意 使 用 了 stringBuilder， 因 为 这 样 可 以 明确 区 分 这 是 一 个 对 象 
初始 化 器 ， 而 不 是 集合 初始 化 器 。 


读者 可 能 认为 使 用 pictionary<, > 这样 的 类 型 举例 会 更 好 ， 但 这 样 做 有 

一 个 潜在 的 风险 。 当 代码 编写 无 误 时 ， 代 码 运 行 自然 也 无 误 ， 但 还 是 建 
议 尽 可 能 使 用 集合 初始 化 器 。 为 什么 昵 ? 看 下 面 两 个 字典 的 初始 化 示 

例 : 一 个 使 用 对 象 初始 化 器 搭配 索引 器 ， 一 个 使 用 集合 初始 化 器 。 


代码 清单 10-6 ”初始 化 字典 的 两 种 方式 


var collectionInitializer = new Dictionary<string, int> <------ C 








{ "A", 20 人 


{ "B", 30 上 
{ "B", 40 } 
}; 
var objectInitializer = new Dictionary<string, int> <------ C# 6 个 
{ 
["A"] 二 20, 
["B"] 二 30, 
["B"] 二 40 
}; 


这 两 种 方式 可 能 看 起 来 是 等 价 的 ， 而 且 对 象 初始 化 器 看 起 来 更 优雅 。 不 
过 这 是 以 没有 重复 键 值 为 前 提 的 。 通 过 字典 索引 器 进行 赋值， 
值 重 复 时 才 兰 当前 值 ， 而 Add 方 法 会 在 遇 到 重复 键 值 时 抛 出 姑 


代码 清单 10-6 中 "B" 键 值 出 现 了 两 次 。 这 是 一 个 很 容易 犯 的 错误 ， 一 般 








写 好 一 行 代码 ， 然 后 复制 粘贴 ， 最 后 修改 其 中 的 键 值 ， 但 很 容易 遗 筷 修 
改 键 值 这 一 步 。 虽 然 这 两 种 方式 都 不 会 导致 编译 错误 ， 但 至 少 集 合 初 始 
化 融 在 执行 期 会 将 错误 暴露 出 来 。 如 果 有 针对 这 段 代 码 的 单元 测试 ， 即 
便 不 显 式 检查 字典 中 的 内 容 ， 也 能 迅速 发 现 其 中 的 bug。 


可 和 否 诉 诸 Roslyn 


显然 ， 如 果 能 在 编译 时 发 现 bug 就 更 好 了 。 编 写 茶 种 分 析 器 来 识别 
对 象 初 始 化 器 和 集合 初始 化 器 中 的 这 个 问题 应 该 是 可 行 的 。 对 于 使 
用 索引 器 的 对 象 初始 化 硕 ， 很 少 有 人 会 故意 指定 在 干 个 相同 的 索引 
值 ， 为 这 种 情况 提示 和 警告 信息 会 比较 合理 。 


目前 似乎 没有 这 样 的 分 析 器 ， 和 希望 尽快 面世 吧 。 在 认识 到 潜在 的 风 
险 后 ， 束 可 以 在 字典 中 使 用 索引 各 了。 


i 0 i a 
儿 种 情况 。 


。 当前 类 型 没有 实现 TIEnumerable 接 口 或 者 没有 适合 的 Add 方 法 ， 导 致 
集合 初始 化 器 不 能 使 用 时 。 不 过 还 是 可 以 自行 实现 Add 扩 展 方 
法 ， 稍 后 介绍 。 ) 例如 concurrentDictionary<,> 束 没有 Add 方 法 ， 
但 它 有 索引 器 。 尽 管 它 有 TryAdd 和 Addorupdate 方 法 ， 但 它们 都 不 能 
被 集合 初始 化 器 使 用 。 而 且 在 使 用 对 象 初始 化 器 时 ， 也 无 须 关 心 当 
前 字典 并 发 更 新 的 问题 ， 因 为 此 时 它 只 被 初始 化 线程 独占 。 

当前 类 型 的 索引 器 和 Add 方 法 对 于 重复 键 值 的 处 理 方 式 一 致 。 字 和 典 
类 型 处 理 重 复 键 值 遭 循 的 原则 是 “ 徊 使 用 Add 则 抛 出 寞 常 ， 知 使 用 过 
引 颖 则 履 善 >”， 但 并 不 意味 着 所 有 类型 都 遵循 同一 原则 。 

确实 需要 蔡 换 现 有 元 素 而 不 是 添加 新 元 素 。 例 如 可 能 需要 使 用 现 有 
字典 来 新 建 一 个 字典 ， 然 后 蔡 换 特定 键 值 。 


此 外 ， 还 有 一 些 界 限 比 较 模 糊 的 情况 ， 这 时 就 需要 在 可 读 性 和 可 靠 性 之 
间 进 行 权 衡 了 。 代 码 清 单 10-7 展 示 了 一 个 SchemalessEntity， 其 中 包含 
两 个 普通 属性 ， 可 以 赋值 任意 的 key/value。 稍 后 会 介绍 初始 化 实例 的 几 
种 可 选 方式 。 


代码 清单 10-7 ”一 个 包含 key 属 性 的 SchemalessEntity 
























































public sealed class SchemalessEntity 
: IEnumerable<KeyValuePair<string, object>> 


private readonly IDictionary<string, object> properties = 


new Dictionary<string, object>(); 


public string Key { get; set; } 
public string Parentkey { get; set,; } 


public object this[string propertyKey] 


get { return properties[propertyKey]; } 
set { properties[propertyKey|] = value; } 
} 


public void Add(string propertyKey, object value) 


{ 
properties.Add(propertykKey, value); 


public IEnumerator<KeyValuePair<string, object>> GetEnumerato 


properties.GetEnumerator(); 


IEnumerator IEnumerable.GetEnumerator() => GetEnumerator(); 


} 


考虑 初始 化 实体 的 两 种 方式 ， 初 始 化 时 需要 指定 一 个 parent key、 一 个 新 
key 和 两 个 属性 (字符 串 表 示 的 name 和 1location) 。 我 们 可 以 使 用 集合 初 
始 化 器 完成 ， 但 之 后 需要 为 其 他 属性 赋值 ， 或 者 在 一 个 对 象 初始 化 器 中 
一 起 完成 ， 不 过 这 种 方式 存在 拼写 错误 的 风险 。 代 码 清单 10-8 展 示 了 两 





种 方式 。 
代码 清单 10-8 初始 化 schemalessEntity 的 两 种 方式 


SchemalessEntity parent 
SchemalessEntity child1 


{ 


{ "Name", "Jon Skeet™" }, 

{ "location", "Reading, UK" } 
}; 
child1.Key = "child-key"; (本 行 及 以 下 1 行 ) 单独 指定 Key 属 性 
childi.Parentkey = parent ,Key 








SchemalessEntity child2 = new SchemalessEntity 


{ 





new SchemalessEntity { Key = 
new SchemalessEntity <------ 


"parent-ke 


使 用 集合 初始 





Key = "child-key"，( 本 行 及 以 下 1 行 ) 在 对 象 初始 化 器 中 指定 Key 属 性 


ParentKey = parent .Key， 











["name"] = "Jon Skeet"，( 本 行 及 以 下 1 行 ) 使 用 索引 器 指定 data 属 性 


["location"] = "Reading, UK" 


哪 种 方式 更 胜 一 筹 呢 ? 在 我 看 来 第 2 种 更 简洁 。 我 通常 还 会 把 name 和 
location 这 两 个 键 设置 为 常量 字符 串 ， 以 降低 键 值 意外 重复 的 风险 。 


如 果 我 们 对 该 类 型 具有 控制 权 ， 那 么 可 以 通过 添加 额外 的 成 员 来 使 用 和 集 
合 初 始 化 器 。 例 如 可 以 添加 Properties 属 性 来 直接 对 外 暴露 字典 或 者 通 
过 添加 视图 暴露 ， 这 样 就 可 以 使 用 对 象 初始 化 器 来 对 key 和 Parentkey 赋 
值 ， 同 时 内 骸 一 个 集合 初始 化 器 来 初始 化 Properties 了。 还 可 以 增加 一 
个 构造 器 ， 该 构造 器 接收 Key 和 parentkey 两 个 参数 ， 这 样 就 可 以 显 式 地 
调用 构造 器 来 对 这 两 个 属性 赋值 ， 然 后 通过 和 集合 初始 化 器 对 name 和 
location 属 性 赋值 。 


前 面 的 内 容 感觉 就 像 在 对 象 初始 化 器 和 集合 初始 化 器 之 间 做 选择 ， 需 要 
考虑 很 多 细 市 ， 其 实 最 终 的 选择 完全 取决 于 个 人 ， 没 有 哪 本 书 能 够 给 出 
针对 每 种 情况 的 最 佳 选择 。 我 们 需要 做 的 就 是 对 每 种 方式 的 优 缺 点 都 了 
然 于 胸 ， 然 后 根据 情况 上 自行 决定 。 


10.2.2 在 集合 初始 化 器 中 使 用 扩展 方法 


C# 6 中 关于 对 象 初始 化 器 和 集合 初始 化 器 的 为 一 个 改进 是 在 集合 初始 化 
器 中 可 以 使 用 哪些 方法 。 特 定 类 型 的 集合 初始 化 右 中 的 方法 此 前 必须 满 
足以 下 两 个 条 件 。 


。 该 类 型 必须 实现 了 TIEnumerable 接 口 。 我 觉得 这 个 限制 条 件 相 当 烦 
人 。 为 了 能 让 某 个 类 型 使 用 集合 初始 化 器 ， 必 须 单 独 为 它 实 现 
IEnumerable 接 口 。 不 过 只 能 接受 现实 ， 因 为 C# 6 并 没有 修改 这 项 限 
制 |。 

。 集合 初始 化 器 中 的 所 有 元 素 都 必须 具备 合适 的 Add 方 法 。 任 何 没有 
大 括号 包围 的 元 素 ， 都 被 视 为 调用 单 参 数 的 Add 方 法 。 如 果 需 要 调 
用 多 参数 的 Add 方 法 ， 则 需要 用 大 括号 包围 这 些 参数 。 


有 时 这 种 要 求 会 让 人 感觉 很 受 限 ， 因 为 很 多 时 候 我 们 只 是 想 简 单 地 创建 
一 个 集合 ， 由 该 集合 来 为 元 系 提 供 合适 的 Add 方 法 。 前 面 说 的 两 个 必要 
条 件 ， 第 1 个 条 件 在 C# 6 中 没有 变动 ， 但 第 2 个 条 件 中 “合适 ”的 含义 发 生 
了 一 些 变化 ， 增 加 了 扩展 方法 。 这 一 改动 在 一 定 程 度 上 可 以 简化 转换 过 
程 。 请 看 下 面 这 个 集合 初始 化 器 : 



































List<string> strings = new List<string> 


{ 
10, 
"hello", 
{ 20, 3 } 
这 段 代 码 等 价 于 : 


List<string> strings = new List<string>(); 
strings.Add(10); 

strings.Add("hello"); 

strings.Add(20, 3); 


其 中 每 个 方法 调用 的 含义 都 会 通过 一 般 的 重 载 决 议 执行 。 如 果 重 载 决 议 
失败 ， 那么 整 个 集合 初始 化 器 将 不 能 通过 编译 。 对 于 普通 的 List<T> 来 
DU 以 上 代码 是 无 法 通 过 编译 的 ， 但 如 果 给 它 添加 一 个 扩展 方法 ， 就 可 

过 编译 了 : 


public static class StringListExtensions 


public static void Add( 
this List<string> list, int value, int count = 1) 


list.AddRange(Enumerable.Repeat(value.ToString(), count)) 


} 


有 了 这 一 特性 ， 第 一 个 和 最 后 一 个 Add 方 法 将 调用 扩展 方法 。 最 后 得 到 
的 list 将 包含 5 个 元 素 〈"10"，"helL1o"，"20"，"20"，"29") ， 因 为 最 后 
一 个 Add 调 用 添加 了 3 个 元 素 。 这 样 的 扩展 方法 其 实 并 不 常见 ， 不 过 它 可 
用 于 展示 以 下 要 点 


ee 这 也 是 这 部 分 内 容 的 全 部 重点 所 


。 代码 中 的 扩展 方法 不 是 泛 型 的 扩展 方法 ， 它 只 能 用 于 List<string> 
类 型 ， 因 此 该 方法 对 于 List<T> 并 不 适用 。 < 此 处 也 可 以 添 
加 泛 型 扩展 方法 ， 只 要 能 推 凯 类 型 实 参 就 行 。 

。 扩 展 方法 中 可 以 使 用 可 选 形 参 : 前 面 的 第 i 被 编 
译 成 Add(10，1)， 因 为 第 2 个 形 参 的 默认 值 是 1。 


了 解 了 该 特性 的 功能 后 ， 下 面 详细 介绍 其 用 途 。 











1. 创建 其 他 通用 的 Add 方 法 


通过 Protocol Buffers 这 个 工作 项 目 ， 我 发 现 了 一 个 有 用 的 技巧 : 使 
用 可 以 接收 集合 作为 参数 的 Add 方 法 。 这 有 点 类 似 于 AddRange， 但 

优点 是 可 以 在 集合 初始 化 器 中 使 用 。 当 需要 在 对 象 初始 化 器 中 初始 
化 某 些 只 读 属性 时 ， 这 一 策略 尤其 有 效 。 


假设 有 一 个 Person 类 ， 包 含 了 一 个 只 读 的 contacts 属 性 。 我 们 把 从 
男 一 个 contacts 列 表 读 取 的 数据 都 添加 到 contacts 属 性 。 在 Protocol 
Buffers 中 ，contacts 属 性 可 能 是 RepeatedField<Person> 类 型 ， 并 
且 RepeatedField<T> 有 适合 的 Add 方 法 ， 这 样 就 可 以 使 用 集合 初始 化 
大 了 了: 

Person jon = New Person 


{ 
Name = "Jon", 
Contacts = { allContacts.Where(c => c.Town == "Reading") 


}; 


可 能 需要 一 些 时 间 适 应 这 种 新 写法 。 一 旦 适应 之 后 ， 就 能 充分 发 挥 
其 优势 了 ， 比 以 前 使 用 jon.contacts.AddRange(...) 这 样 的 方式 高 
明 多 了 。 但 如 果 使 用 的 不 是 Protocol Buffers， 而 且 contacts 只 是 以 
List<Person> 的 形式 对 外 欢 露 呢 ? 即 使 这 样 ， 使 用 C# 6 也 可 从 容 应 
对 : 可 以 为 List<T> 创 建 一 个 扩展 方法 来 实现 Add 方 法 的 重 载 ， 重 载 
方法 接收 IEnumerable<T> 类 型 的 参数 ， 然 后 在 内 部 调用 AddRange 方 
法 ， 见 代码 清单 10-9。 


代码 清单 10-9 通过 扩展 方法 暴露 显 式 接口 实现 


static class ListExtensions 











public static void Add<T>(this List<T> list, IEnumerable< 
list.AddRange(collection); 


有 了 以 上 扩展 方法 ， 即 便 是 List<T> 类 型 的 ， 前 面 的 代码 也 能 正常 
执行 。 如 末 想 进一步 扩展 ， 还 可 以 直接 给 IList<T> 添 加 扩展 方法 。 
不 过 需要 自行 编写 循环 来 添加 元 系 ， 因 为 IList<T> 中 没有 AddRange 
2 








2. 创建 专 有 的 Add 方 法 


还 是 假设 有 一 个 Person 类 ， 其 中 包含 一 个 Name 属 性 。 在 某 个 代码 块 
中 雷 要 频繁 访问 Dictionary<string, Person> 对 象 一 一 使 用 name 作 
为 Person 对 象 的 索引 。 如 果 能 够 只 通过 调 

用 dictionary.Add(person) 来 添加 元 素 会 很 方便 ， 但 问题 

是 Dictionary<string，Person> 作 为 一 个 类 型 并 不 知道 我 们 是 通过 
name 进 行 索引 的 ， 有 什么 解决 办 法 吗 ? 


可 以 创建 一 个 继承 自 Dictionary<string，Person> 的 类 ， 人 然后 添加 
一 个 Add(Person) 方 法 。 但 在 我 看 来 这 种 方式 并 不 理想 ， 因 为 这 并 
不 是 一 种 将 字典 行为 专 有 化 的 方法 ， 而 只 是 一 种 便捷 的 使 用 方法 。 


也 可 以 创建 一 个 更 通用 的 类 ， 这 个 类 实现 IDictionary<TKey， 
TValue> 接 口 ， 并 且 接 收 一 个 委托 ， 该 委托 通过 组 合 完成 TValue 和 
TKey 之 间 的 映射 。 这 种 方式 虽然 更 好 ， 但 是 对 于 这 样 一 个 简单 的 需 
求 来 说 工作 量 过 大 了 。 最 后 ， 我 们 还 是 选择 为 这 个 特定 场景 创建 一 
个 扩展 方法 ， 见 代码 清单 10-10。 


代码 清单 10-10 ”为 字典 添加 一 个 特定 类 型 实 参 的 Add 方 法 


static class PersonDictionaryExtensions 

















public static void Add( 
this Dictionary<string, Person> dictionary, Person pe 


dictionary.Add(person.Name, person); 


} 


在 C# 6 之 前 ， 这 其 实 并 不 是 一 个 好 的 选择 ， 但 是 随 看 using static 
特性 的 引入 以 及 集合 初始 化 嚣 支 持 扩 展 方法 ， 这 种 方式 就 具有 明显 
优势 了 ， 可 以 在 不 重复 任何 名 称 的 情况 下 初始 化 字典 。 


var dictionary = new Dictionary<string, Person> 


{ 














{ new Person { Name 
{ new Person { Name 


"jon" } 人 
"Holly" } } 


}; 


以 上 方式 的 关键 在 于 : 我 们 是 在 为 Dictionary<, > 类 型 实 参 的 特定 
组 合 进行 API 专 有 化 ， 但 没有 改变 所 创建 对 象 的 类 型 。 而 且 其 他 代 
码 无 须 关 心 这 部 分 定制 功能 ， 因 为 这 只 是 表层 的 修改 ， 其 存在 只 是 
为 了 便捷 ， 而 没有 成 为 对 象 的 内 在 行为 。 


说 明 ”这 种 解决 方案 也 存在 一 定 浆 端 : 无 法 阻止 在 初始 化 时 使 
用 Name 之 外 的 属性 。 一 如 既往 ， 建 议 大 家 认真 权衡 方案 的 优 缺 
扩 ， 不 要 盲 从 他 人 的 建议 。 











. 将 被 显 式 接口 实现 所 隐藏 的 现 有 方法 重新 对 外 骏 露 


10.2.1 节 使 用 concurrentDictionary<,> 展 示 了 何 时 使 用 索引 器 而 不 
是 集合 初始 化 器 的 例子 。 在 没有 额外 工作 的 情况 下 ， 是 不 能 使 用 集 
合 初始 化 器 的 ， 因 为 没有 对 外 提供 的 Add 方 法 ， 

但 concurrentDictionary<,> 类 型 确实 存在 一 个 Add 方 法 ， 但 它 使 用 
了 显 式 接 口 实现 。 通 常情 况 下 ， 访 问 采 用 显 式 接 口 实现 的 成 员 ， 需 
要 把 对 象 转换 成 相应 的 接口 类 型 ， 但 它 不 能 用 于 集合 初始 化 器 中 。 
我 们 可 以 通过 提供 一 个 扩展 方法 来 实现 ， 见 代码 清单 10-11。 


代码 清单 10-11 通过 扩展 方法 来 提供 显 式 的 接口 实现 


public static class DictionaryExtensions 








public static void Add<TKey, TValue>( 
this IDictionary<TKey, TValue> dictionary, 
TKey key, TValue value) 
dictionary.Add(key, value); 
} 


乍 一 看 这 么 做 似乎 又 无 意义 。 它 不 过 是 一 个 扩展 方法 调用 了 另 一 个 
同名 方法 而 已 。 但 是 这 样 确 实 有 效 地 解决 了 显 式 接 口 实现 的 问题 ， 
永久 地 对 外 暴露 了 Add 方 法 ， 而 且 可 以 用 于 集合 初始 化 堪 中 。 


var dictionary = new ConcurrentDictionary<string, int> 


{ eX 10 好 
人 


}; 


当然 ， 应 当 齐 慎 使 用 这 种 方式 。 如 果 某 个 方法 被 显 式 接口 实现 所 隐 
藏 ， 那 么 通常 意味 大 不 希望 有 人 无 意 中 调 用 该 方法 。 这 也 体现 了 

using static 选 择 性 引入 扩展 方法 的 好 人 处: 创建 一 个 具有 多 个 静态 
类 的 命名 空间 ， 每 个 静态 类 中 配置 不 同 的 扩展 方法 ， 然 后 只 在 需要 
之 处 引入 特定 静态 类 即 可 。 然 而 即便 这 样 ， 还 是 会 把 Add 方 法 暴露 
给 同一 类 中 的 其 他 代码 。 还 是 那 句 话 ， 如 何 选 择 ， 和 需要 自己 衡量 。 


代码 清单 10-11 中 的 扩展 方法 还 是 太 宽 泛 了 ， 它 把 所 有 字典 类 型 都 
扩展 了 。 我 们 可 以 把 目标 锁定 于 concurrentDictionary<,>， 以 此 避 
免 意 外 调用 其 他 字典 类 型 的 显 式 实现 的 Add 方 法 。 


10.2.3 ”测试 代码 与 产品 代码 


前 面 讲 了 太 多 警告 性 质 的 内 容 。 对 于 这 些 特 性 ， 少 有 界限 清晰 、 能 够 明 
确 使 用 场景 的 。 不 过 其 中 大 部 分 问题 只 针对 有 限 范围 内 的 代码 所 产生 的 


影响 。 
根据 我 的 经 验 ， 对 象 初始 化 器 和 集合 初始 化 莫 通 常用 在 两 处 : 


。 初始 化 完成 后 再 也 不 会 被 修 改 的 集合 静态 初始 化 需 ; 
。 测试 代码 。 


对 于 测试 代码 ， 我 们 依然 需要 考虑 对 外 暴 露 范围 和 方法 执行 的 正确 性 ， 
但 不 必 过 分 关注 。 如 果 给 测试 程序 集 添加 Add 扩 展 方法 不 方便 也 没有 关 
系 ， 因 为 它 完 全 不 会 影响 产品 代码 。 类 似 地 ， 如 果 在 测试 代码 中 的 集合 
人 
影响 其 微 。 


天 于 代码 质量 ， 测 试 代 码 和 产品 代码 确实 有 着 不 同 的 要 求 。 虽 然 测 试 代 
码 也 需要 尽 可 能 保持 高 质量 ， 但 对 于 保持 代码 质量 和 选择 权宜 之 计 之 间 
的 取舍 ， 测 试 代码 和 产品 代码 (尤其 是 公共 API)〉 大 不 相同 。 


扩展 方法 作为 LINQ 特 性 的 重要 组 成 部 分 ， 让 我 们 能 以 更 流畅 的 方式 来 
组 合 不 同 的 操作 。 很 多 时 候 不 再 使 用 多 条 语句 ， 而 是 在 一 条 语句 中 对 多 
个 方法 进行 链 式 调 用 。 这 也 正 是 LINQ 查 询 语句 目前 的 模式 ， 而 这 一 模 
式 在 如 LINQ to XML 此 类 的 API 中 成 为 正统 的 编码 规范 。 这 一 方式 也 会 


























导致 一 个 问题 : 一 旦 过 到 null 值 ， 整 个 调用 部 将 月 尖 。 而 在 C# 6 中 可 以 
安全 地 终止 链 上 的 茶 个 操作 ， 而 不 是 以 抛 出 异常 的 方式 骨 尝 。 


10.3” 空 值 条 件 运 算 符 


关于 可 空 性 的 问题 ， 前 文 已 经 讲 过 了 。 在 和 可 空 性 打交道 时 ， 往 往 会 伴 
随 着 复杂 的 对 象 模 型 ， 拥 有 多 层 属 性 。C# 语 言 设计 团队 在 增强 可 空 性 的 
易 用 性 方面 不 懈 探 索 。 目 前 这 项 工作 仍 在 继续 ， 而 C# 6 已 经 在 这 个 方 问 
上 迈 出 了 坚实 的 一 步 。 在 C# 6 中 处 理 可 空 性 的 代码 可 以 变 得 更 简短 ， 节 
省 很 多 重复 性 的 表达 式 调用 。 


10.3.1 简单 、 安 全 地 解 引 用 


假设 有 一 个 customer 类 型 ， 包 含 Profile 属 性 ，pProfile 属 性 又 包含 一 
个 DefaultshippingAddress 属 性 ， 而 它 叉 包含 一 个 Town 属 性 。 接 下 来 我 
们 需要 找 出 一 个 customer 集 合 中 所 有 默认 邮寄 地 址 中 town 名 称 中 包含 
Reading 的 customer。 如 有 果 不 考 氏 可 空 性 ， 可 以 按照 以 下 方式 实现 ; 


var readingCustomers = allCustomers 
,Where(c => c.Profile.DefaultShippingAddress.Town == "Reading 





如 果 每 个 customer 都 有 profile， 每 个 profile 又 有 default shipping address， 
而 每 个 address 都 有 town 属 性 ， 这 么 写 没 有 问题 ; 但 如 果 以 上 属性 中 任何 
一 个 为 nul1 会 怎么 样 呢 ? 可 能 我 们 只 是 想 剔 除 属性 为 nul1 的 客户 ， 但 最 
终 只 得 到 了 一 个 NullReferenceException。 在 C# 6 以 前 ， 为 了 保证 这 上 段 
代码 正常 运行 ， 需 要 做 非常 复杂 的 改动 : 通过 && 运 算 符 来 检查 每 个 属性 


是 否 为 null。 








var readingCustomers = allCustomers 
.Where(c => c.Profile != Null] && 
c.Profile.DefaultShippingAddress != null && 
c.Profile.DefaultShippingAddress.Town == "Reading 


其 中 包含 很 多 重复 的 代码 ， 而 且 如 有 果 需 要 在 末尾 调用 方法 就 更 糟糕 了 ， 
因为 == 符 号 已 经 蔡 我 们 处 理 了 nul11 值 〈 至 少 对 于 引用 类 型 来 说 如 此 。 
10.3.3 市 会 探讨 一 些 例外 情况 )。 那 么 C# 6 是 如 何 改进 的 呢 ? 它 引 入 了 
空 值 条 件 运算 符 ?.。 使 用 该 运算 符 ， 在 遇 到 nul1 值 时 整个 表达 式 会 终 
止 ， 而 不 是 抛 出 异常 。 一 个 空 值 安全 的 新 版 应 该 如 下 : 


var readingCustomers = allCustomers 
,Where(c => c.Profile?.DefaultShippingAddress?.Town == "Readi 


除了 添加 了 空 值 条 件 运 算 符 ， 这 段 代 码 和 第 一 个 版 本 几乎 完全 相同 。 如 
果 c.Profile 或 者 c.Profile.DefaultShippingAddress 为 null， 整个 == 左 
边 的 表达 式 束 为 nul1。 读 者 可 能 会 问 ， 为 什么 只 使 用 了 两 次 该 运算 符 ， 
而 这 段 代 码 中 有 4 处 可 能 为 nul1。 


.Profile.DefaultShippingAddress 


C 
c.Profile 
C 
c,Profile.DefaultShippingAddress.Town 


这 里 假定 allcustomers 中 的 所 有 元 素 都 为 非 空 引 用 。 如 果 把 这 部 分 的 可 
空 性 也 考虑 进来 ， 就 需要 使 用 c?.Profile 了 ， 表 达 式 中 的 == 写 可 以 处 
理 nul1 值 ， 因 此 表达 式 末尾 无 须 添加 ?运算 符 。 


10.3.2 ”关于 空 值 条 件 运 算 符 的 更 多 细节 


前 面 这 个 例子 只 展示 了 空 值 条 件 运算 符 在 属性 中 的 使 用 方式 ， 而 其 适用 
场景 远 不 止 于 此 ， 它 可 以 用 于 方法 、 字 段 以 及 索引 器 中 。 其 基本 工作 原 
理 是 : 每 遇 到 一 个 空 值 条 件 运算 符 ， 编 译 器 都 会 为 ?前面 的 值 插入 一 条 
空 值 检查 语句 。 如 果 值 为 nul1， 那 么 整个 表达 式 的 运算 终止 ， 并 返回 
nul1 值 ;如 果 值 不 为 nul1， 则 表达 式 继续 同 右 对 属性 、 方 法 、 字 段 或 者 
索引 进行 运算 ， 而 不 需要 对 左边 做 重复 运算 。 如 果 整 个 表达 式 是 非 可 空 
值 类 型 ， 一 旦 其 中 出 现 了 空 值 条 件 运 算 符 ， 整 个 表达 式 的 类 型 就 会 变 成 
对 应 的 可 空 值 类 型 。 


这 里 的 整个 表达 式 ( 即 遇 到 null 值 时 表达 式 计算 停止 的 那 部 分 ) 基本 上 
等 同 于 属性 、 字 段 、 索 引 器 和 方法 访问 的 序列 。 其 他 运算 符 ( 如 比较 运 
算 符 ) 会 中 断 整 个 序列 。 下 面 看 一 下 10.3.1 节 中 where 方 法 的 条 件 。 我 们 
的 lambda 表 达 式 如 下 : 


c => c.Profile?.DefaultShippingAddress?.Town == "Reading" 


编译 器 会 把 以 上 代码 当 作 如 下 代码 来 处 理 : 


string result; 
var tmp1 = c.Profile; 

















if (tmpi == null) 
result = null; 
else 
{ 
var tmp2 = tmpi.DefaultShippingAddress; 
if (tmp2 == null) 
{ 


result = null; 


else 
{ 
result = tmp2.Town; 
} 
return result == "Reading"; 








请 注意 上 面 每 个 属性 访问 《加 粗 的 代码 ) 都 只 出 现 了 一 次 。 前 面 展示 在 
C# 6 之 前 进行 空 值 检查 的 代码 中 ， 可 能 需要 运算 c.Profile 三 次 ， 运 算 

c.Profile.DefaultShippingAddress 两 次 。 如 琳 这 些 运 得 所 依赖 的 数据 _ 

有 可 能 被 其 他 线程 修改 ， 这 就 肪 烦 了 : 即便 通过 了 前 两 个 空 值 检查 ， 最 
终 还 是 会 得 到 一 个 NullReferenceException。 有 J 了 C# 6 之 后 ， 代 码 变 得 
更 安全 、 更 高 效 ， 因 为 所 有 表达 式 都 只 需要 运算 一 次 。 


10.3.3 ”处 理 布尔 值 比较 


目前 我 们 还 是 在 末尾 处 使 用 == 写 来 执行 比较 操作 。 即 便 表达 式 中 出 现 
oe 比较 操作 依旧 需要 执行 。 假 设 我 们 需要 使 用 Equals 方 法 来 进行 
比较 : 


c => c.Profile?.DefaultShippingAddress?.Town?.Equals("Reading") 


然而 这 种 方式 不 能 通过 编译 。 我 们 添加 了 第 3 个 空 值 条 件 运 算 符 ， 这 样 
当 shipping address 的 Town 属 性 为 null 时 ， 丰产 但 如 此 
一 来 整个 lambda 表 达 式 的 结果 是 Nullable<boo1> 类 型 ， 而 不 是 pool 类 
型 ， 也 与 Where 方法 不 匹配 了 。 


在 使 用 空 值 条 件 运 算 符 时 ， 这 个 问题 相当 各 见 。 在 条 件 判 断 中 使 用 空 值 
条 件 运算 符 时 ， 需 要 考 碟 以 下 3 种 可 能 的 执行 情况 : 


。 表达 式 中 的 每 一 部 分 都 运算 过 了 ， 结 果 是 true; 

















。 表达 式 中 的 每 一 部 分 都 运算 过 了 ， 结 果 是 false; 
。 表达 式 因 为 nul1 值 而 中 断 ， 结 果 是 nul1。 


通常 需要 把 上 述 三 种 可 能 缩减 为 两 种 ， 即 把 最 后 一 种 情况 映射 到 true 或 
者 false。 一 般 有 两 种 实现 方式 : 与 条 个 bool 类 型 的 常量 做 比较 ， 或 者 
使 用 空 合 并 运算 符 ??。 


可 空 布 尔 值 比较 操作 的 语言 设计 选择 


在 C# 2 时 期 ，boo1? 与 非 可 空 值 的 比较 操作 给 C# 设 计 团队 带 来 了 夸 
烦 。 这 是 因为 当 x 是 boo1? 类 型 的 变量 时 ， 表 达 式 x == true 和 x != 
false 都 合法 但 含义 不 同 。 如 果 x 为 nul1， 那 么 x == true 的 结果 


是 false，x != false 的 结果 是 true。 ) 


针对 这 种 行为 应 该 如 何 设计 呢 ? 通 常 不 管 选择 哪 种 都 无 法 尽 如 人 
意 。 我 们 需要 做 的 就 是 认识 到 它 的 存在 ， 并 尽 可 能 编写 表意 清晰 的 
代码 ， 来 方便 所 有 人 阅读 和 理解 代码 。 


简化 一 下 前 面 的 例子 ， 假 设 有 一 个 变量 name， 其 类 型 为 string， 但 也 可 
能 为 nul1。 我 们 需要 一 条 if 语句 ， 其 判断 条 件 是 name 调 用 Equals 方 法 ， 

看 结果 是 否 等 于 x。 这 是 展示 条 件 判断 的 简单 方式 : 有 条 件 地 访问 一 个 
布尔 型 的 属性 。 表 10-3 给 出 了 一 些 选 项 : 如 果 name 为 nul1， 是 否 应 当 执 
行 if 中 的 代码 。 


























表 10-3 使 用 空 值 条 件 运 算 符 执 行 布尔 值 比较 的 选择 


如 果 name 为 nul1， 则 不 执行 如 果 name 为 nul1， 则 执行 


if (name?.Equals("X") ?7? false)llif (name?.Equals("X") ?? true) 
If (name?.Equals("X") == true) liif (name?.Equals("X") != false) 





我 倾向 于 选择 空 合并 运算 符 ， 因 为 可 以 把 它 理 解 为 “尝试 执行 比较 操 
作 ， 如 果 操 作 没 有 执行 完 ， 就 采用 ?? 后 的 值 "。 当 表达 

式 name? .Equals("X") 的 类 型 是 Nullable<boo1> 之 后 ， 一 切 就 都 简单 了 。 
只 是 在 空 值 条 件 运 算 符 出 现 之 后 ， 更 容易 遇 到 这 样 的 情形 。 


10.3.4 索引 器 与 空 值 条 件 运 算 符 


前 面 说 过 ， 空 值 条 件 运 算 符 同样 适用 于 索引 器 、 字 7 段 、 属 性 以 及 方法 ， 
语法 也 都 相同 ;但 是 对 于 索引 右 来 说 ， 问 号 要 放 在 方 插 写 之 前 。 它 适用 
i 
型 ， 示 例如 下 : 


int[] array = null; 

int? firstElement = array?[0]; 

关于 索引 器 中 空 值 条 件 运 算 符 的 工作 方式 ， 并 没有 太 多 需要 解释 的 。 空 
值 条件 运 算 符 在 索引 右上 的 应 用 价值 不 如 在 属性 和 方法 ， 不 过 聊 胜 于 
无 ， 起 码 可 以 保持 特性 的 内 部 一 致 性 。 


10.3.5 “使 用 空 值 条 件 运算 符 提升 编程 效率 

前 面 讲 到 在 处 理 可 能 为 nul1 的 属性 时 ， 衬 值 条 件 运算 符 很 有 用 ， 不 过 它 
的 作用 不 止 于 此 。 下 面 列 举 两 个 用 途 以 抛砖引玉 ， 读 者 可 目 行 发 掘 该 特 
性 的 更 多 用 途 。 

1. 安全 便捷 的 事件 触发 


事件 触发 模式 甚至 是 多 线程 的 事件 触发 已 存在 多 年 。 例 如 触发 一 
个 EventHandler 类 型 的 click 事 件 ， 代 码 如 下 所 示 : 


EventHandler handler = Click; 
if (handler != null) 




















handler (this, EventArgs.Empty); 








其 中 有 两 点 需要 重点 注意 。 


o 我 们 可 能 调用 的 不 是 clLick(this，EventArgs.Empty)， 因 
为 click 可 能 为 nu11( 当 处 理 器 没有 订阅 者 时 )。 

。 这 里 把 click 字 上 段 赋值 给 了 一 个 局 部 变量 ， 因 此 在 做 过 空 值 检 
得 后 ， 即 便 click 被 其 他 线程 修改 ， 依 然 不 会 导致 空 引用 。 虽 
然 这 样 做 调用 的 事件 处 理 器 不 是 最 新 的 ， 但 依然 属于 可 以 接受 


的 范 态 条 件 。 


到 目前 为 止 ， 代 码 除 了 有 些 风 长， 没有 其 他 问题 。 然 后 使 用 空 值 条 
件 运 算 符 ， 虽 然 此 时 handler(...) 这 样 的 方式 不 能 使 用 ， 但 可 以 通 
过 Invoke 方 法 完成 调用 : 


Click?.Invoke(this, EventArgs.Empty); 


如 果 此 时 调用 方 ( 例 如 onclick 方 法 ) 仅 此 一 行 代码 ， 则 它 就 是 单 
一 表达 式 主体 ， 可 以 改写 成 表达 式 主体 方法 。 从 安全 性 上 讲 二 者 无 
其 差别， 但 是 第 2 种 写法 更 简洁 。 





.最 大 程度 地 利用 返回 nul1 的 API 
第 9 章 讨 论 日 志 时 讲 过 ， 内 插 字 符 串 字面 量 无 助 于 提升 日 志 记 录 的 
性 能 ， 但 是 它 可 以 和 空 值 条 件 运算 符 搭 配 使 用 。 假 设 有 一 个 如 下 所 
示 的 日 志 API。 

代码 清单 10-12 能够 妥善 处 理 nul1 值 的 日 志 API 框 架 


public interface ILogger <------ 由 像 GetLog 这 样 的 方法 返回 的 接口 
{ 























IActiveLogger Debug { get; } (本 行 及 以 下 3 行 ) 如 果 未 开启 日 志 ，) 
IActiveLogger Info { get; } 
IActiveLogger Warning { get; } 
IActiveLogger Error { get; } 
} 


public interface IActiveLogger <------ 代表 已 开启 日 志 的 接口 


void Log(string message); 





这 只 是 一 个 大 概 的 演示 ， 完 整 的 日 志 API 内 容 肯 定 比 这 多 得 多 。 使 
用 空 值 条 件 运 复 符 ， 我 们 可 以 把 根据 日 志 级 别 获 取 当 前 可 用 logger 
和 执行 志 记 录 这 两 步 结合 在 一 起 ， 编 写 出 的 代码 既 简 洁 高 效 ， 叉 
清晰 易 异 : 


logger .Debug?.Log($"Received request for URL {request.Url}"); 


如 果 debug logging 当 前 处 于 disable 状 态 ， 就 不 会 执行 后 面 的 内 插 字 
符 串 字面 量 ， 也 无 须 创 建 额外 的 对 象 ， 如 果 debug logging 处 于 











enable 状 态 ， 斥 插 池 符 串 学 面 量 就 会 执行 计算 ， 然 后 正音 传递 给 Log 
方法 。 看 到 C# 语 言 人 不断 演 进 ， 令 人 深 感 欣慰。 


当然 ， 这 种 方式 需要 日 志 API 内 部 实现 的 文 持 。 如 采 所 使 用 的 日 志 
API 不 文 持 这 种 写法 ， 也 可 以 通过 扩展 方法 来 实现 。 


很 多 反射 相关 的 API 会 适时 返回 nul1 值 ，LINQ 的 

FirstorDefault 〈 以 及 其 他 类 似 方法 ) 可 以 良好 地 支持 空 值 条 件 运 
算 符 。 类 似 地 ，LINQ to XML 有 很 多 方法 在 无 法 返回 请 求 数据 时 会 
返回 nul1 值 。 假 设 有 一 个 XML 元 素 ， 它 有 一 个 可 选 的 <author> 元 
素 ， 该 元 素 可 能 有 name 属 性 ， 也 可 能 没有 ， 那 么 以 下 两 种 方式 都 可 
以 轻松 获取 author name。 





string authorName 
string authorName 


第 1 条 语句 两 次 使 用 了 空 值 条 件 运 算 符 : 一 次 是 获取 元 素 attribute 
时 ， 一 次 是 访问 该 attribute 的 值 。 第 2 条 语句 利用 了 LINQ to XML 中 
早已 文 持 的 可 空 值 处 理 方式 : 利用 显 式 类 型 转换 。 


10.3.6” 空 值 条 件 运 算 符 的 局 限 性 


空 值 条 件 运算 符 还 有 一 些 不 太 讨 喜 的 方面 ， 其 中 一 个 可 能 会 令 人 吃 恢 : 

空 值 条 件 运算 符 表 达 式 的 结果 是 一 个 值 ， 而 不 是 变量 。 该 限制 导致 我 们 

1 (=) 的 左边 ， 例 如 以 下 几 种 写法 均 
法 : 


person?.Name = ""， 
stats?.RequestCount++,; 
array?[index] = 10; 


这 时 就 需要 用 之 前 的 话语 句 做 判断 了 。 不 过 根据 我 的 经 验 ， 这 几乎 不 算 
什么 问题 。 
对 于 避免 NullReferenceException 来 说 ， 空 值 条 件 运 算 符 作用 非 几 ， 不 


过 有 时 需要 处 理 寞 常 ， 而 不 是 避免 它们 。 和 异常 过 小 占 特 性 是 目 C# 诞 生 以 
来 天 于 catch 块 结构 的 第 一 个 特性 。 


book.Element("author")?.Attribute("name") 
(string) book.Element("author")?.Attribut 




















10.4 ”异常 过 滤 右 


本 间 的 最 后 一 个 特性 有 些 尴 罚 :， 该 特性 是 C# 跟 随 Visual Basic 步 伐 的 一 
项 举措 。Visual Basic 从 诞生 之 初 就 具备 异常 过 滤器 特性 ， 但 直到 C# 6， 
该 特性 才 被 引入 C# 中 。 该 特性 可 能 应 用 较 少 ， 不 过 通过 它 ， 我 们 可 以 深 
入 了 解 CLR 的 内 部 原理 。 异 和 常 过 滤器 的 基本 原理 是 : 可 以 根据 过 滤器 返 
回 true 还 是 false 来 决定 是 否 捕 获 异 常 。 如 果 人 返回 true， 那 么 捕获 异 

常 ， 如 果 返 回 false，catch 块 将 忽略 该 异常 。 


假设 我 们 正在 执行 一 个 web 操作 ， 并 且 已 知 连 接 的 服务 器 有 时 会 断 线 。 
如 果 连 接 失 败 ， 我 们 需要 执行 一 些 寞 常 处 理 操作 ， 但 是 对 于 其 他 失败 ， 
都 需要 照常 抛 出 寞 第 。 在 C# 6 之 前 ， 我 们 只 能 先 捕获 异常 ， 然 后 判断 寞 
常 的 类 型 ， 抛 出 不 属于 连接 异常 的 那些 。 


try 
{ 











.<------ 尝试 Web 操 作 
Ah (WebException e) 
if (e.Status != WebExceptionstatus.ConnectFailure) (本 行 及 以 下 3 
throw; 


.<------ 处 理 连接 失败 























而 使 用 异常 过 滤器 的 话 ， 即 可 实现 不 去 捕获 那些 不 需要 处 理 的 异 负 ， 直 
接 从 catch 块 中 过 小 这 类 异常 即 可 : 


try 





a 尝试 Web 操 作 


catch (webException e) 
when (e.Status == WebExceptionStatus.ConnectFailure) <------ 

















i 处 理 连接 异常 











除了 上 述 特定 场景 ， 寞 常 过 小 右 还 可 以 应 用 于 男 外 两 个 普 衣 的 场景 : 重 
试 和 日 志 。 在 重 试 循环 中 ， 只 有 需要 对 当前 操作 进行 重 试 〈 满 足 特定 条 

















件 并 且 没 有 超出 重 试 次 数 ) ， 才 应 该 捕获 异 前 ; 在 日 志 场 景 中 ， 完 全 不 
需要 捕获 异 解 ， 而 是 将 异 冲 记 入 日 志 。 在 展示 更 多 具体 用 例 之 前 ， 首 先 
介绍 该 特性 的 语法 和 行为 。 


10.4.1 异常 过 滤器 的 语法 和 语义 

第 一 个 完整 示例 见 代码 清单 10-13: 它 人 遍历 一 个 messages 集 合 ， 对 于 集合 
中 每 个 元 素 都 抛 出 一 次 异常 。 我 们 添加 一 个 异常 过 小 占 ， 这 样 只 有 当 

message 中 包含 catch 这 个 词 时 ， 才 捕获 异常 。 代 码 中 异常 过 小 器 的 部 分 
己 加 粗 。 

代码 清单 10-13” 抛 出 三 个 异常 并 捕获 其 中 两 个 


string[] messages = 











"You can catch this", 
"You can catch this too", 
"This won't be caught" 


foreach (string message in messages) <------ 在 try/catch 语 句 外 循环 丈 
try 
{ 


throw new Exception(message); <------ 每 次 使 用 不 同 的 messagej 


} 
catch (Exception e) 
when (e.Message.Contains("catch")) <------ 只 有 当 message 中 1 





Console.writeLine($"Caught 'f{e.Message}'"); <------ 打印 捕 
} 
执行 结果 是 被 捕获 的 两 个 异常 : 


Caught 'You can catch this' 
Caught 'You can catch this too' 


未 被 捕获 异常 的 输出 结果 是 : This won't be caught。 (这 是 一 个 大 概 
的 结果 ， 精 确 的 输出 结果 取决 于 执行 代码 的 方式 。) 


从 语法 上 讲 ， 异 常 过 小 妖 的 内 容 就 这 么 多 : 上 下 文 关 键 字 when 之 后 跟 一 
对 小 括号 ， 括 号 中 是 表达 式 。 表 达 式 可 以 使 用 catch 块 中 声明 的 异常 变 





量 ， 且 执行 结果 必须 是 布尔 类 型 ， 不 过 异常 过 小 右 的 语义 要 更 复 森 。 
1. 双 通 路 异常 模型 


CLR 人 处理 异常 的 方式 为 : 在 异常 被 逐 级 同上 抛 出 时 ，CLR 不 断 释 放 
调用 栈 ， 直 至 捕获 异常 ， 而 其 背后 的 机 制 可 能 更 惊人 。 该 过 程 比 使 
用 双 通 路 模型 更 为 复杂 1。 该 模型 采用 以 下 几 个 步骤 。 


o 异 各 抛 出 ， 第 1 条 通路 开始 。 

o CLR 自 上 而 下 检查 栈 空间 ， 寻 找 可 以 处 理 当 前 异常 的 catch 
(我 们 把 这 一 步 简称 为 处 理 catch 块 ， 不 过 这 并 不 是 官方 
语 。) 

o 只 有 具备 兼容 异常 类 型 的 catch 块 才 会 被 考虑 。 

o 如 果 该 catch 块 中 有 异常 过 滤 右 ， 那 么 先 执行 异常 过 滤器 。 如 
果 过 滤器 返回 false， 则 catch 块 不 处 理 异 和 常 。 

o 不 包含 异常 过 滤器 的 catch 块 等 价 于 包含 异常 过 滤器 返回 true 

的 catch 块 。 

处 理 catch 块 确定 了 之 后 ， 第 2 条 通路 开始 。 

o 
释放 。 

o 在 释放 栈 的 过 程 中 ， 所 有 finally 块 将 被 执行 。 (不 包括 处 
理 catch 块 所 对 应 的 finally 块 。) 

o 人 处理 catch 块 执行 。 











O 〇 


代码 清单 10-14 展 示 了 该 过 程 。 它 包含 3 个 方法 : Bottom、Middle 和 
Top。 其 中 Bottom 调 用 Middle， 而 Middle 会 调用 Top， 这 样 就 形成 了 
一 个 自 描 述 的 调用 栈 。 然 后 Main 方 法 会 通过 调用 Bottom 来 开始 整个 
调用 链 。 这 段 代 码 看 起 来 比较 长 ， 但 并 没有 什么 实质 性 的 复杂 巡 
辑 ， 大 可 放心 。 另 外 ， 异 党 过 滤器 的 代码 已 加 粗 。LogAndReturn 方 
法 是 为 奶 踪 调用 而 设 ， 异 常 过 滤 右 会 使 用 该 方法 来 记录 特定 方法 ， 
然后 返回 特定 值 来 显示 是 否 应 当 捕 获 该 异常 。 


代码 清单 10-14 弄 常 过 滤器 的 三 层 结构 展示 


static bool LogAndReturn(string message，bool result) (本 行 及 L 








Console.writeLine(message); 


return result,; 








} 
static void Top() 
{ 
try 
{ 
throw new Exception( ) ; 
} (本 行 及 以 下 3 行 ) 在 第 2 条 通路 中 执行 的 finally 块 
finally 
{ 
Console.writeLine("Top finally"); 
} 
} 
static void Middle() 
{ 
try 
Top(); 
catch (Exception e) 
when (LogAndReturn("Middle filter", false)) <------ 司 
Console.WriteLine("Caught in middle"); <------ 永远 不 乡 
} 
finally (本 行 及 以 下 3 行 ) 在 第 2 条 通路 中 执行 的 finally 块 
{ 
Console.writeLine("Middle finally"); 
} 
} 
static void Bottom() 
{ 
try 
Middle( ); 
catch (IOException e) 
when (LogAndReturn("Never called", true)) <------ 永远 
{ 
catch (Exception e) 
when (LogAndReturn("Bottom filter", true)) <------ 每 : 
Console.WriteLine("Caught in Bottom"); <------ 该 行 会 祁 
} 


static void Main() 


Bottom( ); 


有 了 前 面 的 过 程 描述 和 代码 中 的 各 种 注释 ， 读 者 可 以 目 行 推 朵 出 执 
行 结果 。 接 下 来 核对 一 下 执行 结 末 ， 以 确保 没有 任何 存 括 之 处 ， 首 
先是 打印 结果 : 


Middle filter 
Bottom filter 
Top finally 
Middle finally 
Caught in Bottom 


图 10-2 展 示 了 执行 过 程 。 其 中 左 侧 是 调用 栈 (省 略 Main 方 法 ) ， 中 
间 是 对 于 当前 事件 的 描述 ， 右 侧 是 该 步骤 的 输出 结果 。 








图 10-2 ”代码 清单 10-14 的 执行 流程 
双 通 路 模型 的 安全 影响 


finally 块 执行 的 时 序 会 影响 using 和 1ock 语 句 ， 这 一 点 对 于 
try/finally 或 者 using 中 的 内 容 有 重要 影响 ， 因 为 代码 的 执行 
环境 可 能 包含 恶意 代码 。 如 果 有 非 受 信 代 码 调 用 我 们 的 方法 ， 
而 我 们 的 方法 可 以 抛 出 异常 ， 调 用 方 就 可 以 在 finally 块 执行 
之 前 通过 异常 过 滤器 来 执行 代码 了 。 


以 上 内 容 表 明 : 对 安全 敏感 的 代码 不 要 出 现在 finally 块 中 。 
例如 在 try 块 中 进入 一 个 较 蜗 权限 的 状态 ， 然 后 finally 块 中 的 
代码 回 到 一 个 较 低 权限 的 状态 ， 此 时 其 他 代码 就 可 能 在 仍 处 于 
较 高 权限 时 被 执行 。 不 过 很 少 需要 考虑 此 类 安全 问题 ， 因 为 代 
码 多 数 时 候 是 在 比较 友好 的 环境 中 运行 的 ， 但 是 我 们 必须 意识 
到 存在 这 样 的 风险 。 知 想 提 升 安全 度 ， 可 以 语 加 一 个 带 有 有 弄 负 
过 滤器 的 空 catch 块 ， 该 过 滤器 负责 移 除 相关 权限 并 返回 
a 














2. 多 次 捕获 同一 类 型 的 异常 


以 前 对 于 同一 个 try 块 ， 如 果 在 不 同 的 catch 块 捕获 同一 个 异常 类 
型 ， 会 引发 编译 器 报错 ， 因 为 永远 不 会 执行 到 第 2 个 catch 块 ; 但 是 
有 了 和 异常 过 滤器 之 后 ， 情 况 就 不 同 了 。 


稍微 扩展 之 前 webException 的 那个 例子 。 假 设 需要 根据 用 户 提 供 的 
URL 来 获取 网 页 内 容 ， 我 们 可 能 需要 以 一 种 方式 来 处 理 连接 失败 ， 
以 另 一 种 方式 处 理 名 称 决 议 失 败 ， 然 后 让 其 余 异常 上 浮 到 更 高 层级 
的 catch 块 。 借 助 异常 过 滤器 ， 易 于 实现 这 一 日 标 : 
try 
{ 

， <------ 尝试 Web 操 作 


catch (webException e) 
when (e.Status == WebExceptionStatus.ConnectFailure) 
{ 


DR 处 理 连 接 失败 























catch (webException e) 
when (e.Status == WebExceptionSstatus.NameResolutionFailur 

















<------ 处 理 名 称 决议 失 败 











如 末 需 要 在 当前 层级 处 理 其 他 所 有 webException， 只 需要 在 前 两 个 
专 有 catch 块 之 后 再 添加 一 个 通用 的 、 不 含 过 滤 絮 的 


catch(WebException e) {...}。 
了 解 了 异常 过 小 占 的 工作 原理 之 后 ， 回 到 先前 的 那 两 个 普遍 的 场 


景 。 虽 然 这 两 个 使 用 场景 并 没有 时 括 过 滤器 的 全 部 用 途 ， 不 过 有 助 
于 我 们 识别 其 他 相似 类 似 的 使 用 场景 ， 首 先 讨论 重 试 。 








1 我 并 不 清楚 异常 处 理 模型 的 起 源 ， 我 怀疑 它 是 根据 Windows Structured 
Exception Handling (SEH) 机制 直接 映射 而 来 ， 不 过 这 一 话题 属于 CLR 
更 深层 次 的 内 容 ， 这 里 无 意 继续 探究 。 


10.4.2 ” 重 试 操作 


随 着 云 计 算 技 术 的 普及 ， 我 们 应 当 更 加 注意 那些 可 能 会 失败 的 操作 ， 并 

且 认 真 思 考 这 些 操作 失败 对 代码 有 何 影响 。 对 于 远程 操作 ， 例 如 Web 服 

有 时 只 是 一 些 暂时 性 的 失败 ， 我 们 需要 对 这 些 操 
进行 重 试 。 


把 握 好 重 试 准 则 


里 然 执 行 重 试 操作 很 有 用 ， 但 仍 需 要 意识 到 ， 代 码 中 的 每 一 层 都 有 
可 能 尝试 重 试 失败 的 操作 。 如 果 有 多 个 抽象 层 可 以 优雅 且 透 明 地 重 
试 某 个 暂时 性 的 失败 ， 那 么 最 后 可 能 会 导致 茶 个 实际 的 失败 被 严重 
拖 后 记录 日 志 。 简 而 言 之 ， 这 个 模式 并 不 是 上 自治 的 。 


当 能 够 控制 程序 的 整个 执行 栈 时 ， 我 们 应 当 认真 思考 哪里 应 当 执 行 
重 试 操作 。 如 果 我 们 只 负责 程序 的 一 部 分 工作 ， 就 要 考虑 把 重 试 操 
作 设 置 是 可 配置 的 ， 这 样 那些 掌控 整个 执行 栈 的 开发 人 员 就 可 以 决 
定 我 们 的 这 一 层 是 否 应 当 执 行 重 试 操作 。 

产品 级 的 重 试 处 理 更 为 复杂 ， 可 能 需要 复杂 的 局 发 机 制 来 决定 何 时 触及 


重 试 以 及 重 试 操作 应 当 持 续 多 久 ， 并 且 要 设计 一 种 重 试 间 隔 时 长 的 随机 
化 机 制 ， 以 避免 不 同 的 客户 同时 发 起 重 试 。 代 码 清单 10-15 展 示 了 一 个 




















高 度 简 化 的 版 本 2， 以 便 我 们 聚焦 于 腊 种 过 滤器 。 


2 我 认为 所 有 重 试 机 制 都 应 当 使 用 过 滤器 来 检查 哪些 失败 可 以 重 试 ， 以 
及 决定 重 试 调用 之 间 的 间隔 时 长 。 


代码 需要 知道 : 


。 需要 执行 什么 操作 ; 
。 尝试 操作 的 重复 次 数 。 


在 这 种 情况 下 ， 只 有 需要 重 试 操 作 时 才 使 用 异常 过 滤器 来 捕获 异常 。 代 
码 很 直截了当 。 


代码 清单 10-15 一 个 简单 的 重 试 循环 


static T Retry<T>(Func<T> operation, int attempts) 








while (true) 
try 


attempts--,; 
return operation(); 


} 
catch (Exception e) when (attempts > 0) 
Console.writeLine($"Failed: {e}"); 


Console.WriteLine($"Attempts left: {attempts}"); 
Thread.Sleep(5000); 


} 


虽然 极 不 推荐 while(true) 这 种 写法 ， 但 在 本 例 中 它 比 较 合 理 。 我 们 可 
以 编写 一 个 基于 retrycount 作 为 条 件 的 循环 ， 不 过 异常 过 小 器 已 经 提供 
了 该 功能 ， 因 此 这 么 做 具有 误导 性 。 此 外 ， 和 循环 必须 是 可 结束 的 ， 因 此 
如 果 方 法 末尾 没有 return 或 者 throw 这 样 的 语句 ， 是 不 能 通过 编译 的 。 
然后 就 可 以 通过 调用 上 述 方法 完成 重 试 了 : 


Func<DateTime> temporamentalCall = () => 











DateTime utcNow = DateTime.UtcNow; 


if (utcNow.Second < 20) 
{ 


throw new Exception("I don't like the start of a minute") 


return utcNow; 


}; 


var result = Retry(temporamentalCall, 3); 
Console.writeLine(result); 


一 般 说 来 ， 这 上 段 代码 会 并 刻 返 回 结 果 。 有 时 如 果 在 某 一 分 钟 的 前 10 秒 左 
右 执行 ， 这 段 代 码 会 失败 几 次 之 后 才 成 功 。 有 时 如 果 刚 好 在 茶 一 分 钟 的 
开始 时 执行 ， 这 段 代 码 会 失败 儿 次 ， 捕 捉 并 记录 异常 ， 等 到 第 3 次 失败 
的 时 候 ， 寞 常 束 不 会 被 捕 获 了。 


10.4.3 ”记录 日 志 的 “副作用 ” 


第 2 个 例子 是 关于 如 何 实 时 地 将 异常 记录 到 日 志 中 。 我 使 用 日 志 的 例子 
展示 C# 6 的 很 多 特性 ， 这 不 过 是 巧合 而 已 。C# 设 计 团 队 应 该 不 会 让 C# 6 
的 目标 只 着 眼 于 日 志 ， 它 们 只 是 刚好 在 类 似 的 情况 下 很 适用 而 已 。 


关于 记录 异常 日 志 的 方式 和 时 机 的 话题 ， 存 在 广泛 和 争议， 本 书 不 做 讨 
论 。 这 里 假定 无 论 寞 第 是 否 会 被 捕获 (可 能 发 生 二 次 记录 ) ， 都 需要 在 
日 志 中 记录 异常 。 

使 用 日 志 过 滤器 可 以 在 不 影响 执行 流程 的 情况 下 记录 日 志 。 实 现 方 法 很 
简单 : 在 异常 过 滤 具 中 调用 记录 日 志 的 方法 ， 然 后 返回 false 来 表明 不 
需要 捕获 当前 异常 。 代 码 清单 10-16 中 的 Main 方 法 就 采用 了 这 种 方式 : 
可 以 在 引发 错误 码 之 前 将 包含 时 间 戳 的 民利 记录 到 日 志 中 。 

代码 清单 10-16 在 过 滤器 中 记录 日 志 


static void Main() 






























































try 
UnreliableMethod(); 


catch (Exception e) when (Log(e)) 
{ 
} 

} 


static void UnreliableMethod() 


throw new Exception("Bang!"); 


} 
static bool Log(Exception e) 


Console.writeLine($"{DateTime.UtcNow}: {e.GetType()} {e.Messa 
return false; 


这 段 代码 在 很 大 程度 上 只 是 代码 清单 10-14 的 一 个 变 体 ， 那 个 例子 通过 
日 志 来 探 完 双 通路 腊 津 系统 的 语义 ; 而 在 本 例 中 ， 不 会 在 过 渡 占 中 捕获 
异常 ， 整 个 try/catch 和 过 滤器 都 只 是 为 了 记录 日 志 这 个 “副作用 ”而 已 。 


10.4.4 单个 、 有 针对 性 的 日 志 过 小 器 

除了 那些 通用 的 例子 ， 特 定 的 业务 逻辑 有 时 会 要 求 捕获 菏 些 异常 ， 而 继 
续 向 上 抛 出 另外 一 些 异 常 。 这 种 做 法 有 什么 用 吗 ? 我 们 总 是 捕获 通用 的 
Exception 多 呢 ? 还 是 捕获 IOException 或 SqlException 之 类 的 特定 异常 


多 呢 ? 考虑 以 下 代码 : 


catch (IOException e) 








} 
可 以 把 这 上 段 代码 视 为 : 
catch (Exception tmp) when (tmp is IOException) 

IOException e = (IOException) tmp; 
i 
C# 6 的 异种 过 滤器 就 是 以 上 代码 的 一 个 通用 版 本 。 很 多 时 候 无 法 通过 异 
常 的 类 型 来 获取 相关 信息 。 以 SqlException 为 例 ， 它 有 一 个 Number 属 
性 ， 该 属性 对 应 一 个 异常 原因 。 我 们 经 党 需要 根据 不 同 的 SQL 失 败 原因 
来 采取 不 同 的 处 理 措施 。 出 于 API 的 缘故 ， 从 webException 中 得 到 相关 


的 HTTP 状 态 码 会 有 点 困难 ， 但 对 404 (Not Found) 错误 和 500 (Internal 
Error) 错误 区 别处 理 也 很 必要 。 











有 一 点 需要 注意 ;强烈 呼吁 不 要 根据 有 异常 信息 来 进行 过 滤 代码 清单 

10-13 那 种 实验 性 目的 除外 ) 。 寞 党 信息 在 不 同 的 太行 版 本 中 古 不 确定 

的 ， 可 能 会 根据 执行 环境 的 不 同 进行 属地 化 。 根 据 异常 信息 来 对 腊 第 进 
行 区 别处 理 不 可 取 。 


10.4.5 ”为 何不 直接 抛 出 异常 


读者 可 能 会 有 疑问 ， 如 此 大 费 周章 地 过 滤 异 常 ， 目 的 是 什么 ”毕竟 完全 
可 以 直接 抛 出 异 第 。 使 用 异常 过 滤 占 的 代码 如 下 所 示 : 


catch (Exception e) when (condition) 























} 
和 直接 抛 出 异 冲 看 起 来 并 无 太 大 区 别 : 
catch (Exception e) 

if (!condition) 


throw; 


} 
这 点 改进 足以 成 为 一 个 新 的 语言 特性 吗 ? 结论 还 有 答 商 梭 。 


以 上 两 段 代码 其 实 存 在 差异 : 前 面 讲 过 ，condition 的 运算 时 机 是 随 着 
上 层 调 用 栈 的 finally 块 而 变化 的 。 此 外 ， 虽 然 throw 语 句 可 以 保留 大 部 
分 原始 调用 栈 ， 但 仍然 存在 某 些 细微 的 差别 ， 尤 其 是 异 癌 捕获 和 重新 抛 
出 位 置 的 栈 结 构 。 这 就 造成 了 诊断 问题 时 的 难 易 之 分 。 


我 认为 寞 肖 过 滤器 的 出 现 不 会 对 开 友 者 的 日 第 工作 产生 太 大 影响 。 不 同 
于 表达 式 主体 成 员 和 内 插 字 符 串 字面 量 这 些 特性 ， 异 常 过 滤器 并 不 是 一 
个 让 人 难以 割舍 的 特性 ， 但 也 聊 胜 于 无 。 

纵 观 本 章 介绍 的 所 有 特性 ，using static 和 空 值 条 件 运 算 符 毫 无 疑问 是 


我 最 常用 的 特性 。 这 两 个 特性 应 用 十 分 广泛 ， 很 多 时 候 能 够 显著 增强 代 
码 可 读 性 。 (尤其 当代 码 中 需要 处 理 很 多 预定 义 第 量 时 ，using static 




















对 于 保证 可 读 性 能 起 到 关键 作用 。) 


空 值 条 件 运算 符 、 对 象 初 始 化 器 和 集合 初始 化 器 的 改进 ， 使 得 仅 用 一 条 
表达 式 即 可 实现 复 森 的 操作 。 它 们 增强 了 C#33 引 入 的 对 象 初始 化 器 和 集 
合 初 始 化 器 : 表达 式 可 以 用 于 字段 初始 化 中 ;方法 实 参 无 须 单独 计算 ， 
提升 了 便捷 度 。 


10.5 小结 


。 使 用 using static 指 令 ， 可 以 实现 不 用 每 次 指定 类 型 名 称 ， 束 能 指 
代 静 态 类 型 成 员 《〈 一 般 是 党 量 或 者 方法 ) 。 

。 using static 会 把 指定 类 型 中 的 所 有 扩展 方法 也 一 并 引入 ， 这 样 束 
无 须 再 通过 命名 空间 引入 扩展 方法 了 。 

。 引入 扩展 方法 规则 发 生 了 变化 ， 这 意味 着 把 普通 静态 方法 变 成 扩展 
方法 不 再 是 同 后 兼容 的 改动 。 

。 集合 初始 化 器 在 初始 化 集合 时 ， 可 以 调用 类 型 预定 义 的 Add 方 法 ， 
也 可 以 调用 Add 扩 展 方法 。 

。 对 象 初始 化 器 可 以 使 用 索引 右 ， 不 过 需要 在 索引 占 和 集合 初始 化 屁 
之 间 做 好 权衡 。 

。 在 链 式 操作 调用 中 ， 如 果 某 个 链 中 的 元 素 可 能 为 ul11， 那 么 使 用 空 
值 条 件 运 算 符 ?. 可 以 极 大 地 简化 操作 。 

。 寞 第 过 滤 絮 提供 了 对 异常 的 更 多 控制 ， 既 可 以 根据 异常 类 型 ， 也 可 
以 根据 异常 数据 来 确定 是 人 否 需 要 捕获 寞 第 。 

















第 四 部 分 C#7 及 其 后 续 版 本 
C# 7 是 自 C#1 以 来 第 一 个 包含 多 个 小 版 本 的 友 行 版 1， 它 共有 4 个 版 本 : 


1Visual Studio 2002 引 入 了 C# 1.0，Visual Studio 2003 引 入 了 C# 1.2。 不 
清楚 为 什么 中 间 略 过 了 1.1 版 本 ， 而 且 这 两 个 发 行 版 之 间 的 区 别 也 不 明 
i 


。 C# 7.0 在 2017 年 3 月 同 Visual Studio 2017 15.0 一 起 发 布 ; 
。 C# 7.1 在 2017 年 8 月 同 Visual Studio 2017 15.3 一 起 发 布 ; 
。 C# 7.2 在 2017 年 12 月 同 Visual Studio 2017 15.5 一 起 发 布 ; 
。 C# 7.3 在 2018 年 5 月 同 Visual Studio 2017 15.7 一 起 发 布 。 





这 些小 版 本 大 都 只 是 在 之 前 C# 7.x 发 行 版 特性 基础 上 进行 了 扩展 ， 而 没 
有 引入 全 新 的 特性 ， 不 过 第 13 章 要 介绍 的 引用 类 型 相关 特性 在 C# 7.2 中 
得 到 了 大 幅 扩 展 。 


据 我 所 知 ， 目 前 还 没有 发 布 C# 7.4 的 计划 ， 但 也 不 能 完全 排除 这 种 可 能 
人 C# 8 也 许 会 采用 类 似 的 发 
儿 制 。 


本 书 对 于 C# 7 的 讨论 会 多 于 C# 6， 因 为 C# 7 的 特性 更 为 复杂 。 无 论 从 编 
译 器 的 处 理 方 式 还 是 从 CLR 的 使 用 方式 上 讲 ， 元 组 与 其 他 类 型 都 有 着 显 
著 的 区 别 。 局 部 方法 这 个 特性 引 人 注 目 ， 因 为 其 实现 方式 可 以 和 ]ambda 
表达 式 相 比较 。 模 式 匹 配 易 于 理解 ， 但 是 如 何 充分 发 挥 其 价值 ， 仍 需要 
复杂 性 ， 虽 然 听 起 来 挺 简单 的 

( 特 指 in 参数 ) 。 


很 多 开发 人 员 认 为 C# 6 的 特性 在 日 党 开发 中 很 有 用 处 ， 而 C# 7 的 一 些 特 
性 根本 用 不 上 。 比 如 我 在 代码 中 很 少 使 用 元 组 ， 因 为 我 开发 所 面 问 的 平 
台 并 不 支持 元 组 。 另 外 ， 我 也 不 篆 使 用 引用 类 型 相关 特性 ， 因 为 在 我 的 
编程 环境 中 这 项 特性 施展 不 开 。 不 过 这 些 都 不 影响 它们 成 为 优秀 的 新 特 
性 ， 只 能 说 这 些 特 性 的 应 用 还 不 是 很 广泛 。C# 7 的 其 他 特性 ， 比 如 模式 
匹配 、throw 表 达 式 以 及 数字 字面 量 的 改进 则 会 让 所 有 开发 人 员 受 益 ， 
不 过 在 影响 力 上 可 能 不 如 那些 针对 性 更 强 一 些 的 特性 。 

















上 述 内 容 旨 在 帮 读 者 建立 一 种 预期 。 一 如 往常 ， 当 学 习 一 个 新 特性 时 ， 
要 思考 自己 在 代码 中 会 如 何 应 用 它 。 当 然 ， 不 必 强 迫 自 己 运用 新 特性 ， 
在 简短 的 代码 中 用 不 到 大 部 分 语言 特性 。 即 便 目 前 用 不 到 某 项 特性 也 没 
有 关系 ， 只 需要 知道 其 存在 即 可 ， 将 来 需要 时 它 会 涛 上 用 场 的 。 


另外 预告 一 下 第 15 章 的 内 容 ， 第 15 章 将 展望 C# 语 言 的 未 来 。 这 一 章 主 要 
介绍 那些 在 C# 8 预览 版 中 己 经 可 用 的 特性 ， 不 过 最 终 发 行 版 不 一 定 包含 
所 有 这 些 特性 ， 也 可 能 会 有 本 书 未 谈 及 的 某 些 新 特性 。 和 希望 读者 关注 新 
版 本 的 发 布 和 C# 团 队 的 博客 更 新 。 对 于 C# 开 发 人 员 而 言 ， 不 论 是 现今 
所 拥有 的 ， 还 是 更 加 美好 的 未 来 ， 都 是 那么 激动 人 心 。 

















第 11 间 使 用 元 组 进行 组 合 
本 章 内 容 概览 


使 用 元 组 来 组 合 数据 ; 

元 组 语法 一 一 字面 量 和 类 型 ; 
元 组 转换 ; 

CLR 中 如 何 表 示 元 组 ; 

元 组 的 蔡 代 方法 以 及 使 用 指南 。 


在 C# 3 时 代 ，LINQ 的 出 现 改变 了 处 理 数据 集合 的 方式 。 其 中 之 一 是 能 
够 针对 每 个 元 系 的 处 理 提供 操作 如何 转换 元 素 形式 ， 如 何 从 结果 中 篇 
选 特定 元 系 ， 或 者 如 何 根 据 每 个 元 系 的 茶 个 方面 进行 排序 。 尺 管 如 此 ， 
对 于 非 集合 的 数据 ，LINQ 却 没 能 提供 很 多 新 工具 。 


匿名 类 型 虽然 提供 了 一 种 组 合 数据 的 方式 ， 但 使 用 限制 太 大 ， 只 能 用 于 
特定 代码 块 中 。 我 们 无 法 声明 一 个 返回 匿名 类 型 的 方法 ， 因 为 无 法 命名 
返回 类 型 。 


C# 7 引入 了 元 组 ， 使 用 元 组 可 以 组 合 数据 ， 也 可 以 把 组 合 好 的 类 型 拆 分 
成 单独 的 部 分 。 也 许 有 读者 觉得 C# 已 经 通过 system.Tuple 实 现 了 对 元 组 
的 文 持 ， 这 不 完全 对 。 虽 然 元 组 已 经 存在 于 framework 中 ， 但 是 并 没有 
得 到 语言 层面 的 文 持 。 更 令 人 迷惑 的 是 ，C# 7 没有 把 这 些 元 组 作为 有 语 
言 支 持 的 元 组 ， 而 是 使 用 了 一 个 新 的 System.valueTuple 类 型 集合 ，11.4 
节 会 介绍 。11.5.1 节 还 会 把 它 和 system,Tuple 进 行 比 较 。 


11.1 元 组 介绍 


使 用 元 组 ， 可 以 将 多 个 独立 的 值 组 合成 一 个 值 。 元 组 只 是 简单 地 将 这 些 
值 组 合 起 来 ， 并 不 负责 为 互相 关联 的 数据 进行 任何 封 朔 。 同 时 C# 7 引入 
了 新 语法 ， 方 便 了 操作 元 组 。 


假设 有 寿 干 整 型 数 ， 我 们 需要 一 次 束 找 出 其 中 的 最 大 值 和 最 小 值 。 直 观 
而 言 ， 似 乎 应 该 把 这 部 分 实现 放 到 一 个 方法 中 ， 但 是 该 方法 的 返回 值 应 
该 是 什么 类 型 呢 ? 我 们 可 以 返回 最 小 值 ， 然 后 通过 out 参 数 返回 最 大 



































值 ， 或 者 直接 使 用 两 个 ut 参数。 不 过 这 两 种 方式 都 太 过 笨拙 了 。 当 

然 ， 也 可 以 创建 一 个 单独 的 类 型 作为 返回 类 型 ， 不 过 有 点 小 题 大 做 了 。 
或 者 ， 可 以 返回 一 个 Tuple<int，int> 类 型 ， 该 类 型 是 由 .NET 4 引入 的 ， 
但 是 使 用 该 类 型 又 无 法 分 辨 最 大 值 和 最 小 值 〈 而 且 需 要 为 仅仅 两 个 值 创 
建 一 个 对 象 ) 。 我 们 可 以 使 用 C# 7 的 元 组 类 型 ， 如 下 所 示 声 明 该 方法 : 


static (int min, int max) MinMax(IEnumerable<int> Source ) 
之 后 就 可 以 以 如 下 方式 调用 了 : 


int[] values = { 2, 7, 3, -5, 1, 0, 10 }; 











var extremes = MinMax(values); <------ 调用 方法 计算 最 大 值 和 最 小 值 并 返 匠 
Console.writeLine(extremes.min); <------ 打印 最 小 值 ~5 
Console.writeLine(extremes.max); <------ 打印 最 大 值 10 


稍 后 会 给 出 MinMax 方 法 的 知 干 个 实现 ， 不 过 这 个 例子 已 经 充分 体现 了 该 
特性 的 设计 初衷 ， 后 续 会 铺展 该 特性 的 全 部 细节 。 虽 然 元 组 特性 听 起 来 
比较 简单 ， 但 实际 需要 学 习 的 内 容 很 多 ， 并 且 这 几 方 面部 是 互相 关联 
的 ， 也 就 不 好 按照 茶 种 逻辑 顺序 来 前 述 。 在 阅读 本 章 时 ， 如 果 该 者 产生 
了 “这 又 是 什么 ? ”的 想法 ， 建 议和 暂且 收 起 疑惑 ， 坚 持 读 完 本 革 。 本 半 内 
容 虽 多 ， 但 都 不 算 艰深 ， 论 述 着 重 全面 。 硕 望 经 过 本 章 的 学 习 ， 该 者 的 
所 有 疑惑 都 可 以 迎刃而解 1。 


1 如 果 仍 有 疑问 ， 可 从 Author Online 论 坛 或 者 Stack Overflow 上 获取 更 多 
志向， 


























11.2 元 组 字面 量 和 元 组 类 型 


可 以 把 元 组 看 作 CLR 引 入 的 一 些 新 类 型 ， 然 后 提供 了 相应 的 语法 糖 ， 使 
得 新 类 型 更 易 用 。 易 用 包括 两 个 层面 : 声明 和 构建 。 下 面 首先 从 C# 语 言 
层面 抽 丝 剥 芋 ， 暂 不 考虑 C# 到 CLR 之 间 的 映射 关系 ， 然 后 回 过 头 解释 编 
译 堪 幕后 所 完成 的 工作 。 


11.2.1 语法 





C# 7 引入 了 两 点 新 语法 : 元 组 字面 量 和 元 组 类 型 。 二 者 看 上 去 比较 接 
近 : 都 是 用 小 括号 包围 、 由 喜 呈 分隔 的 两 个 以 上 元 素 组 成 。 在 元 组 字面 
量 中 ， 每 个 元 系 都 有 一 个 值 和 一 个 可 选 名 称 ; 而 在 元 组 类 型 中 ， 每 个 元 











素 都 有 一 个 类 型 和 可 选 名 称 。 图 11-1 是 元 组 字面 量 的 示例 ， 图 11-2 是 元 
组 类 型 的 示例 。 每 幅 图 中 都 包含 一 个 具名 元 素 和 一 个 不 具名 元 素 。 





图 11-1 包含 元 素 值 为 5 和 "text" 的 元 组 字面 量 ， 第 2 个 元 素 的 名 称 为 
title 


图 11-2 包含 元 素 类 型 为 int 和 6uid 的 元 组 类 型 ， 第 1 个 类 型 的 名 称 为 x 


在 实际 编码 中 ， 一 般 所 有 元 素 都 有 和 名称， 或 者 所 有 元 素 都 没有 名 称 。 例 
如 元 组 类 型 (int，int) 或 者 (int x，int y，int z)， 元 组 字面 量 为 (x: 
1，y: 2) 或 者 (1，2，3)， 不 过 这 并 不 是 强制 性 的 要 求 。 对 于 元 素 命名 ， 
需要 注意 以 下 两 项 限制 。 


。 不 论 是 在 元 组 字面 量 还 是 元 组 类 型 中 ， 都 不 能 出 现 重 名 元 素 ， 比 如 
(x: 1，x: 2) 这 样 的 字面 量 ， 既 不 被 允许 也 没有 任何 意义 。 

在 元 组 中 ， 如 果 需 要 给 元 素 取 名 为 ItemN 这 种 形式 〈 其 中 N 是 一 个 整 
数 ) ， 只 有 在 N 和 元 素 的 位 置 〈 从 1 开始 ) 完全 吻合 的 情况 下 才 行 ， 
因此 (Item1: 9，Item2: 60) 是 合法 命名 ， 但 是 (Item2: 09, Item1: 0) 


古 非 法 命名 ， 稍 后 解释 原因 。 


元 组 类 型 用 于 指定 一 个 类 型 ， 其 用 途 和 其 他 类 型 相同 : 声明 变量 、 方 法 
返回 类 型 等 。 元 组 字面 量 则 用 于 指定 一 个 表达 式 值 ， 只 古 把 单个 值 组 合 
成 一 个 元 组 值 。 






































元 组 中 的 元 素 值 可 以 是 除 指针 外 的 任何 值 。 方 便 起 见 ， 本 章 大 部 分 示例 
使 用 和 常量 值 〈 主 要 是 整 型 和 字符 串 〉 ， 不 过 在 元 组 中 经 常会 使 用 变量 作 
为 元 素 值 。 类 似 地 ， 元 组 中 元 系 类 型 也 可 以 是 非 指针 的 任何 类 型 : 数 
组 、 类 型 形 参 甚至 其 他 元 组 类 型 。 


了 解 了 元 组 基本 语法 之 后 ， 就 能 理解 MinMax 方 法 的 返回 类 型 (int min,， 
int max) 了 。 


。 这 是 一 个 具有 两 个 元 素 的 元 组 。 

。 第 1 个 是 名 为 min 的 int 元 素 。 

e。 第 2 个 是 名 为 max 的 int 元 系 。 
掌握 了 元 组 字面 量 的 写法 ， 就 可 以 完成 MinMax 方 法 的 实现 了 ， 见 代码 清 
单 11-1。 


代码 清单 11-1 使 用 元 组 来 表示 最 大 值 和 最 小 值 


static (int min, int max) MinMax( <------ 返回 值 是 有 具名 元 素 的 数组 
IEnumerable<int> source) 
{ 





























using (var iterator = source.GetEnumerator()) 
if (!iterator.MoveNext()) <------ 防止 空 序 列 


throw new InvalidOperationException( 
"Cannot find min/max of an empty sequence"); 
} 
int min = iterator.Current; (本 行 及 以 下 1 行 ) 使 用 普通 int 类 型 变 ; 
int max = Iterator,Current 
while (iterator ,MoveNext( ) ) 
{ 日 
min 
max 


Math ,Min(min，iterator.Current)， (本 行 及 以 下 1 行 ) 
Math.Max(max, iterator.Current); 





return (min, max); <------ 使 用 min/max 创 建 元 组 
} 


在 代码 清单 11-1 中 ， 唯 一 涉及 该 新 特性 是 返回 类 型 ， 前 面 解释 过 
了 ，return 语 句 使 用 了 元 组 字面 量 : 


return (min, max); 


截至 目前 ， 还 没有 探讨 元 组 字面 量 的 类 型 。 前 面 只 讲 过 它们 是 用 于 创建 
元 组 值 的 ， 不 过 这 里 先 卖 个 关子 。 我 们 现在 所 使 用 的 元 组 字面 量 都 不 包 
售 元 素 名 称 ， 人 至 少 在 C# 7.0 中 是 没有 的 ， 其 中 min 和 max 是 方法 中 声明 的 
局 部 变量 ， 它 们 用 于 元 组 字面 量 的 元 素 值 。 


元 组 元 系 名 称 要 匹配 恰当 的 变量 名 


以 上 代码 中 变量 名 称 和 方法 返回 类 型 中 元 素 的 名 称 是 相同 的 ， 这 是 
巧合 吗 ? 在 编译 器 看 来 绝对 是 巧合 。 就 算 我 们 把 返回 类 型 声明 为 
(waffle: int，icecream: int)， 编 译 器 也 都 无 所 谓 。 


但 是 对 于 代码 阅读 者 来 说 ， 这 就 不 能 是 巧合 了 : 因为 名 字 相 同意 味 
痢 元 组 元 素 和 变量 的 合 义 相同 。 如 果 我 们 发 现 名 称 明显 不 一 致 ， 就 
要 检查 代码 中 是 否 有 bug 或 者 考虑 重新 命名 。 


现在 定义 术语 : 元 组 字面 量 或 者 元 组 类 型 中 元 素 的 个 数 称 为 元 组 的 度 ， 
例如 (int，long) 的 度 是 2，("a"，"b"，"c") 的 度 是 3。 元 素 的 类 型 与 元 
组 的 度 无 关 。 


说 明度 其 实 并 不 算是 新 术语 ， 之 前 讨论 泛 型 时 介绍 过 度 的 概念 ， 
泛 型 的 度 指 的 是 类 型 形 参 的 个 数 。List<T> 的 度 是 1， 
而 Dictionary<TKey，TValue> 的 度 是 2。 


关于 “元 组 元 系 名 称 要 匹配 恰当 的 变量 名 >”，C# 7.1 的 一 项 改进 体现 了 这 
= 
























































11.2.2 ”元 组 字面 量 推 叶 元 素 名 称 〈C# 7.1) 


在 C# 7.0 中 ， 需 要 在 代码 中 显 式 给 出 元 组 元 素 名 称 ， 但 是 这 种 要 求 经 六 
导致 代码 见 余 : 元 组 字面 量 中 指定 的 名 称 ， 需 要 和 提供 值 的 属性 或 者 局 
部 变量 名 匹配 ， 其 中 一 种 简单 形式 如 下 : 


var result = (min: min, max: max); 


元 素 名 称 推 斯 机制 不 仅 适 用 于 简单 的 变量 ， 也 运用 于 属性 。 我 们 经 常会 
使 用 属性 来 初始 化 元 组 ， 这 在 LINQ 使 用 投射 机 制 时 尤为 普遍 。 


在 C#7.1 中 ， 元 组 元 素 的 值 如 果 来 日 变量 或 者 属性 ， 那 么 可 以 推断 出 元 








素 名 称 ， 推 断 过 程 和 匿名 类 型 名 称 推 朵 完全 一 致 。 为 了 展示 该 特性 的 用 
途 ， 考 虑 3 种 编写 LINQ to Objects 的 查询 方法 ， 该 查询 会 把 两 个 集合 进 
行 连接 ， 以 此 获取 名 称 、 职 位 名 称 以 及 员工 部 门 。 首 先是 LINQ 使 用 匿 
名 类 型 的 传统 写法 : 


from emp in employees 
join dept in departments on emp.DepartmentId equals dept.Id 
select new { emp.Name, emp.Title, DepartmentName = dept.Name }; 


然后 使 用 元 组 加 显 式 元 系 名 称 的 方式 : 


from emp in employees 
join dept in departments on emp.DepartmentId equals dept.Id 
select (name: emp.Name, title: emp.Title, departmentName: dept.Na 


最 后 是 通过 C# 7.1 的 名 称 推断 : 


from emp in employees 
join dept in departments on emp.DepartmentId equals dept.Id 
select (emp.Name, emp.Title, DepartmentName: dept.Name); 


这 项 特性 实现 了 以 更 简洁 的 代码 来 创建 包含 有 效 名 称 元 组 的 目标 。 


虽然 这 里 只 是 通过 LINQ 来 展示 ， 但 该 特性 可 以 用 于 任何 元 组 字面 量 
中 。 例 如 给 定 一 个 元 素 的 列表 ， 我 们 可 以 根据 count、min 和 max 来 创建 
元 组 ， 其 中 可 以 对 count 使 用 名 称 推断 。 





List<int> list = new List<int> { 5, 1, -6, 2 }; 

var tuple = (list.Count, Min: list.Min(), Max: list.Max()); 
Console.writeLine(tuple.cCcount); 
Console.writeLine(tuple.Min); 

Console.writeLine(tuple.Max); 


请 注意 ， 对 于 Min 和 Max， 还 是 需要 目 行 指定 名 称 ， 因 为 这 两 个 值 是 从 方 
法 调用 中 获取 的 。 无 论 是 元 组 元 素 还 是 匿名 类 型 属性 ， 都 无 法 通过 方法 
调用 来 推断 名 称 。 


还 有 一 个 问题 ， 如 果 两 个 推断 名 称 重 名 ， 那 么 两 个 推断 都 会 被 放弃 。 如 

果 推 盎 名 条 尔 和 显 式 名 和 尔 发 生 训 突 ， 那 么 优先 选择 显 式 名 称 ， 剩 下 的 一 个 

。 了解 了 如 何 指定 元 组 类 型 和 元 组 字面 量 ， 那 么 它们 有 
么 用 呢 ? 

















11.2.3 ”元 组 用 作 变 量 的 容器 


接 下 来 的 这 句 话 可 能 会 让 人 感到 震 尺 : 元 组 类 型 是 公共 的 、 具 有 读 写 权 
限 的 值 类 型 。 我 始终 坚持 不 使 用 可 变 值 类 型 ， 并 坚持 把 字段 设 为 私有 ; 
但 凡事 难免 例外 ， 比 如 元 组 。 


大 部 分 类 型 不 仅仅 是 纯 数据 数据 都 有 相应 的 含义 。 有 时 还 有 对 数据 的 
校 验 ， 有 时 不 同 数 据 间 彼 此 会 有 关联 。 通 常 都 是 因为 数据 有 其 内 在 合 
义 ， 对 数据 的 操作 才 有 意义 。 


然而 元 组 恰恰 相反 。 元 组 的 作用 就 像 数 据 的 一 个 简单 容器 。 如 果 有 两 个 
变量 ， 那 么 这 两 个 变量 可 以 独立 变化 。 二 者 并 没有 内 在 关联， 也 不 存在 
任何 附带 联系 。 元 组 的 机 制 也 是 完全 相同 的 ， 区 别 残 是 可 以 把 这 些 独 六 
的 变量 打包 ， 切 作 一 个 伍 。 巡 对 于 公 能 返回 一 个 但 的 万 法 来 襄 尤其 备 
女 o 





图 11-3 比 较 了 二 者 。 左 边 是 三 个 独立 声明 的 变量 ， 右 边 是 把 其 中 两 个 变 
量 放 进 一 个 元 组 (椭圆 形 中 的 部 分 )。 在 右边 的 代码 中 ，name 和 score 
组 成 一 个 元 组 ， 赋 值 给 了 player 变 量 。 完 全 可 以 把 二 者 当 作 独立 变量 
《例如 打印 player.score) ， 也 可 以 把 二 者 当 作 一 个 整体 〈 例 如 把 新 值 
赋 给 player 变 量 ) 。 


图 11-3 ”左边 三 个 独立 变量 ， 右 边 两 个 变量 ， 其 中 一 个 是 元 组 


一 旦 接受 了 元 组 是 变量 的 容器 这 个 概念 ， 很 多 事情 就 更 合理 了 ， 但 这 些 
变量 又 是 什么 呢 ? 前 面 讲 到 如 果 元 组 元 素 有 名 称 ， 那 么 可 以 通过 名 称 访 
问 相 应 的 元 素 。 如 果 元 系 没 有 名 称 ， 义 该 如 何 访 问 呢 ? 
1. 通过 名 称 和 位 置 来 访问 元 系 
还 记得 前 面 天 于 元 系 名 称 有 一 项 限制 吧 ? 就 是 天 于 形 如 ItemN 这 样 
的 命名 方式 ， 其 中 N 是 一 个 整 型 数 。 那 是 因为 任何 元 组 中 的 变量 都 
可 以 通过 其 位 置 进行 访问 ， 也 可 以 通过 名 称 进行 访问 。 变 量 还 是 那 
个 变量 ， 只 是 有 不 同 的 访问 方式 而 已 ， 示 例如 下 。 
代码 清单 11-2 ”通过 元 素 名 称 和 位 置 实现 元 素 的 读 / 写 访问 


























var tuple = (x: 5, 10); 
Console .writeLine(tuple.x); (本 行 及 以 下 1 行 ) 使 用 名 称 和 位 置 获取 并 打 E 
Console.writeLine(tuple.Item1); 











Console.writeLine(tuple,.Item2); <------ 第 2 个 元 素 不 具名 ， 因 此 只 能 
tuple.x = 100; <------ 通过 名 称 修改 第 1 个 元 素 
Console,WriteLine(tuple,Item1);，<------ 通过 名 称 打印 第 1 个 元 素 (1 





现在 应 该 明日 为 什么 (Item1: 19，29) 这 种 写法 合法 ， 而 (Item2: 
10，20) 非 法 了 吧 。 第 1 种 写法 相当 于 命名 元 余 ， 而 第 2 种 写法 会 造 
成 Item2 出 现 二 义 性 : 指 的 到 底 是 第 1 个 元 素 〈 根 据 名 称 ) 还 是 第 2 
个 元 素 〈 根 据 位 置 ) 。 有 人 可 能 会 说 (Ttem5: 106，29) 应 该 可 以 了 
吧 ， 因 为 这 个 元 组 里 只 有 两 个 元 素 ， 它 不 可 能 指 代位 置 ， 只 能 是 名 
称 。 对 于 这 种 情况 ， 只 能 说 从 技术 层面 讲 没有 造成 二 义 性 ， 但 依然 
具有 迷惑 性 ， 因 此 这 种 写法 也 是 被 禁止 的 。 
既然 元 组 在 创建 完成 后 还 能 修改 它 的 值 ， 那 么 可 以 改写 MinMax 方 
法 。 我 们 使 用 一 个 元 组 局 部 变量 来 保存 当前 值 ， 取 代 之 前 两 个 独立 
变量 min 和 max， 见 代码 清单 11-3。 

代码 清单 11-3 ”在 MinMax 方 法 中 使 用 元 组 来 取代 两 个 局 部 变量 


static (int min, int max) MinMax(IEnumerable<int> Source ) 


{ 























using (var iterator = source.GetEnumerator()) 
If (!iterator.MoveNext()) 


throw new InvalidoperationException( 
"Cannot find min/max of an empty sequence"); 


var result = (min: iterator.Current，( 本 行 及 以 下 1 行 ) 使 
max: iterator ,Current ) 
while (iterator ,MoveNext( ) ) 


resu1lLt .min 
result.max 


Math.Min(result.min, iterator.Curren 
Math.Max(result.max, iterator.Curren 


} 
return result; <------ 直接 返回 元 组 


} 
实际 上 代码 清单 11-3 和 代码 清单 11-1 在 工作 方式 上 非常 接近 ， 区 别 








只 是 把 两 个 局 部 变量 整合 到 了 一 起 : 原先 是 source、iterator、min 
和 max， 现 在 是 source、iterator 和 result，result 中 包含 了 min 和 
max。 这 两 种 方式 的 内 存 使 用 和 性 能 相同 ， 只 有 编码 方式 不 同 。 这 
种 新 写法 比 原来 的 更 好 吗 ? 见仁见智 。 这 只 是 局 部 的 选择 行为 ， 纯 
粹 属于 实现 上 的 细节 。 








. 把 元 系 当 作 单个 值 


鉴于 我 们 正在 逐步 重新 实现 之 前 的 方法 ， 接 下 来 考虑 方法 的 为 一 种 
实现 方式 。 下 面 的 代码 把 一 个 新 值 赋 给 result .min， 把 男 一 个 新 值 


赋 给 result .max: 








result .min 
result .max 


如 果 直 接 给 result 赋 值 ， 就 可 以 把 以 上 代码 缩减 成 一 条 语句 ， 如 代 
码 清 单 11-4 所 示 。 


代码 清单 11-4 在 MinMax 中 重新 给 元 组 赋值 


static (int min, int max) MinMax(IEnumerable<int> Source ) 


{ 


Math.Min(result.min, iterator.Current); 
Math.Max(result.max, iterator.Current); 


using (var iterator = source.GetEnumerator()) 


If (!iterator.MoveNext()) 


{ 
throw new InvalidoperationException( 
"Cannot find min/max of an empty sequence"); 


} 


var result = (min: iterator.Current, max: iterator.Cu 
while (iterator.MoveNext()) 


{ 
result = (Math.Min(result.min, iterator.Current), 
Math.Max(result.max, iterator.Current)) 
return result,; 


} 


同样 ， 这 两 种 方式 并 没有 太 大 差别 ， 因 为 代码 清单 11-3 中 元 组 元 素 
古 单独 更 新 的 ， 它 们 指 代 上 一 次 循环 的 结果 。 其 实 


用 IEnumerable<int> 类 型 的 斐 波 那 契 数列 2 为 例 的 话 会 更 有 说 服 力 。 
C# 已 经 通过 赋予 迭代 器 yield 的 功能 帮助 我 们 完成 这 一 功能 了 。 代 码 
清单 11-5 展 示 了 一 个 十 分 有 说 服 力 的 C# 6 的 实现 。 


代码 清单 11-5 不 使 用 元 组 实现 翡 波 那 契 数列 
static IEnumerable<int> Fibonacci() 


int current = 0; 
int next = 1; 
while (true) 


yield return current ; 
Int nextNext = current + next 
current = next,; 
next = nextNext,; 
} 
} 


在 迭代 过 程 中 ， 都 会 退 踪 元 素 当前 值 和 下 一 个 值 。 每 一 次 欠 代 ， 卷 

会 把 当前 值 和 下 一 次 的 值 ， 更 新 为 下 一 次 和 下 下 次 值 ， 因 此 束 需 要 

一 个 临时 变量 。 不 能 简单 地 把 下 一 个 值 依次 直接 赋 给 current 和 

next 变 量 ， 因 为 第 1 次 赋值 会 导致 第 2 次 赋值 信息 丢失 。 

如 末 使 用 元 组 ， 就 可 以 在 一 条 赋值 语句 中 给 两 个 元 素 赋值 。 虽 然 在 
对 J 汪 。 


代码 清单 11-6 ”使 用 元 组 实现 斐 波 那 契 数列 


static IEnumerable<int> Fibonacci() 





var pair = (current: 0, next: 1); 
while (true) 


yield return pair.current; 
pair = (pair.next, pair.current + pair.next); 


和 
} 


既然 讲 到 这 里 ， 有 必要 介绍 如 何 把 这 个 方法 一 般 化 ， 以 便 生成 任意 
序列 。 我 们 把 斐 波 那 契 数列 的 相关 代码 抽取 出 来 ， 变 成 一 个 方法 调 
用 。 代 码 清 单 11-7 包 含 了 一 个 一 般 化 的 Generatesequence 方 法 ， 可 


以 根据 其 实 参 生 成 各 种 序列 。 
代码 清单 11-7 ”将 辈 流 那 契 数列 的 生成 过 程 进行 分 离 


static IEnumerable<TResult> (本 行 及 以 下 12 行 ) 方法 用 于 根据 前 一 个 状态 
GenerateSequence<TState, TResult>( 
TState seed, 
Func<TState, TState> generator, 
Func<TState, TResult> resultSelector) 





{ 
var state = seed; 
while (true) 
yield return resultSelector(state); 
state = generator(state); 
} 
} 


# 应 用 示例 

var fibonacci = GenerateSequence( (本 行 及 以 下 3 行 ) 使 用 序列 生成 器 生 
(current: 0, next: 1), 
pair => (pair.next, pair.current + pair.next), 
pair => pair.current); 


当然 ， 使 用 匿名 或 者 具名 的 类 型 也 可 以 实现 以 上 代码 ， 不 过 就 没有 
这 样 优 雅 了 。 拥 有 其 他 编程 语言 开发 经 验 的 读者 可 能 不 会 对 这 段 代 
码 感 到 应 寞 ，C#7 并 没有 种 来 全 新 的 范式 ， 但 是 能 够 用 C# 写 出 如 此 
美观 的 代码 ， 还 是 很 令 人 欣喜 的 。 

介绍 了 元 组 的 使 用 方式 之 后 ， 下 面 继续 深入 。 接 下 来 主要 考虑 类 型 
转换 ， 还 会 讨论 元 系 名 称 在 不 同 场 景 下 重要 性 的 差异。 


2 前 两 个 元 素 分 别 是 0 和 1， 后 面 每 个 元 素 都 等 于 它 前 面 两 个 元 素 之 和 。 
11.3 元 组 类 型 及 其 转换 
前 面 一 直 尽量 避 免 讨 论 元 组 字面 量 的 类 型 。 在 这 个 问题 没有 溢 清 的 情况 


下 ， 用 了 很 多 代码 来 直观 展示 元 组 的 用 法 。 下 面 要 践 行 本 书 “ 深 入 解 
析 ” 的 守则 了 ， 首 先 回顾 讲 过 的 使 用 var 和 元 组 字面 量 的 所 有 声明 。 




















11.3.1 元 组 字面 量 的 类 型 





有 些 元 组 字面 量具 有 类 型 ， 有 些 则 不 上 具有。 其 规则 比较 简单 : 当 元 组 中 
所 有 元 素 都 具有 类 型 时 ， 元 组 才 具 有 类 型 。C# 中 一 直 存 在 没有 类 型 的 表 
达 式 。lambda 表 达 式 、 方 法 组 以 及 null 字 面 量 都 是 没有 类 型 的 表达 式 。 
和 这 些 没有 类 型 的 表达 式 一 样 ， 我 们 不 能 把 无 类 型 的 元 组 赋值 给 隐 式 类 
型 局 部 变量 。 例 如 下 面 这 个 例子 是 合法 的 ， 因 为 10 和 20 都 是 具有 类 型 的 
表达 式 : 

var valid = (10, 20); 

但 下 面 这 个 就 非法 ， 因 为 null 字 面 量 是 没有 类 型 的 : 

var invalid = (10, null); 


与 null 字 面 量 类 似 ， 无 类 型 的 元 组 字面 量 也 可 以 转换 成 一 个 类 型 。 一 旦 
元 组 有 了 类 型 ， 那 么 所 有 元 素 名 都 要 成 为 该 类 型 的 一 部 分 。 


在 表 11-1 中 ， 两 边 的 表达 式 是 等 价 的 。 
表 11-1 




















var tuple = (x: 10, 20); (int x, int) tuple = (x: 10，20) 


var array new[] {("a", 10)}; (string, int)[] array = {("a", 1 

string[] input = {"a", "b" }; 

IEnumerable<(string, int)> query 
input.Select<string, (string, 
(x => (x, x.Length)); 


string[] input = {"a", "b" }; 
var query = input 
.Select(x => (x, x.Length)); 




















第 一 个 例子 展示 了 元 组 字面 量 的 元 素 名称 是 如 何 变 成 元 组 类 型 的 一 部 分 
的 。 后 一 个 例子 展示 了 在 复杂 情况 下 类 型 推断 是 如 何 工 作 的 input 的 
类 型 会 让 lambda 表 达 式 中 x 的 类 型 固定 到 string 上 ， 然 后 x.Length 也 就 顺 
理 成 章 地 完成 了 类 型 绑 定 。 这 样 元 组 字面 量 中 元 素 的 类 型 束 是 string 和 
int， 于 是 可 以 推 新 出 lambda 表 达 式 的 返回 类 型 为 (string，int)。 代 码 
清单 11-7 中 有 过 类 似 的 推断 ， 束 是 生成 翡 波 那 契 数列 的 那个 方法 。 不 过 
那 时 并 不 关注 类 型 。 


具有 类 型 的 元 组 字面 量 应 该 没什么 问题 ， 但 没有 类 型 的 元 组 字面 量 怎么 
办 ? 如何 把 没有 名 称 的 元 组 字面 量 转 换 成 有 名 称 的 元 组 类 型 ? 要 解答 这 

















个 问题 ， 需 要 从 更 广义 的 角度 看 符 元 组 转换 。 


考虑 两 种 转换 方式 : 从 元 组 字面 量 到 元 组 类 型 的 转换 ， 以 及 元 组 类 型 之 
间 的 转换 。 第 8 章 讲 过 类 似 的 转换 差异 : 可 以 从 内 插 字 符 串 字 面 量 表 达 
式 转换 到 Formattablestring， 但 是 不 能 从 string 类 型 转换 
ny 同样 的 规则 也 适用 于 元 组 。 首先 介绍 第 一 种 转 








lambda 表 达 式 的 参数 可 能 看 起 来 像 元 组 


只 具有 单个 参数 的 lambda 表 达 式 不 会 引起 迷惑 ， 但 如 果 是 两 个 参 

数 ， 看 起 来 就 很 像 元 组 了 。 看 一 个 有 用 的 例子 : LINQ 中 Select 的 

东 个 重 载 方法 ， 它 提供 了 元 系 索 引 和 值 的 映射 关系。 通 币 会 有 为 其 
他 操作 提供 索引 的 需求 ， 因 此 把 索引 和 值 放 到 一 个 元 组 中 是 很 合理 
的 ， 于 是 就 有 如 下 所 示 的 代码 : 

static IEnumerable<(T value, int index)> WithIndex<T> 


(this IEnumerable<T> source) => 
source.Select((value, index) => (value, index)); 


注意 看 其 中 lambda 表 达 式 的 部 分 : 


(value, index) => (value, index) 











(value，index) 第 1 次 出 现 的 位 置 并 不 是 元 组 字面 量 ， 而 是 lambda 表 
达 式 参数 序列 。 第 2 次 出 现 的 位 置 才 是 元 组 字面 量 ， 是 lambda 表 达 
式 的 返回 值 。 

这 么 写 并 没什么 错误 ， 这 里 只 是 提 个 醒 。 

11.3.2 ”从 元 组 字面 量 到 元 组 类 型 的 转换 
与 C# 的 其 他 部 分 类 似 ， 存 在 从 元 组 字面 量 的 显 式 类 型 转换 和 隐 式 类 型 转 
换 。 其 中 显 式 类 型 转换 的 用 途 不 广 ， 后 面 会 谈 到 。 一 旦 了 解 了 隐 式 类 型 
转换 的 原理 ， 显 式 类 型 转换 就 没什么 太 大 用 处 了 。 

1. 隐 式 类 型 转换 


当 同 时 满足 以 下 两 个 条 件 时 ， 元 组 字面 量 可 以 隐 式 转换 为 元 组 类 




















型 


o 字面 量 与 类 型 的 度 相同 ; 

o 每 个 元 组 元 素 都 可 以 隐 式 转换 为 对 应 的 元 素 。 

第 1 点 比较 简单 ， 如 果 (5，5) 能 够 转换 为 (int，int，int) 就 很 奇怪 
了 。 最 后 一 个 值 完全 无 法 转换 。 第 2 点 略微 复杂 ， 下 面 举 例 说 明 ， 
首先 请 看 如 下 转换 : 


(byte, object) tuple = (5, "text"); 


根据 上 面 的 规则 摘 述 ， 我 们 需要 根据 源 元 组 中 的 每 个 元 素 (5， 
"text") 来 检查 其 对 应 元 妹 (byte，object ) 是 否 存在 隐 式 类 型 转换 。 
如 果 每 个 元 素 都 符合 ， 那 么 整个 转换 也 是 有 效 的 : 

















虽然 int 到 byte 不 存在 隐 了 式 类 型 转换 ， 但 是 存在 整 型 疝 量 5 到 byte 的 
隐 式 类 型 转换 《因为 5 处 于 byte 类 型 的 表示 范围 之 内 ) 。 从 字符 串 
字面 量 到 object 也 存在 隐 式 类 型 转换 。 由 于 所 有 转换 都 合法 ， 因 此 
整个 转换 自然 合法 。 再 看 一 个 例子 : 


(byte, string) tuple = (300, "text"); 


再 对 每 个 元 组 应 用 隐 式 类 型 转换 : 


这 里 试图 把 整 型 第 量 300 转 换 成 byte 类 型 。 由 于 300 超 出 了 byte 的 有 
效 范 围 ， 因 此 不 存在 相应 的 隐 式 类 型 转换 。 虽 然 可 以 用 显 式 类 型 转 
换 把 300 转 换 成 byte， 但 是 这 里 不 起 作用 ， 因 为 这 里 是 在 完成 整个 
元 组 字面 量 的 转换 。 字 符 串 字面 量 到 string 存 在 隐 式 类 型 转换 ， 但 
由 于 第 一 个 转换 不 成 立 ， 因 此 整个 转换 也 是 无 效 的 。 如 果 编 译 这 段 
代码 ， 将 得 到 一 个 指向 元 组 字面 量 中 300 的 编译 错误 : 


error CS0029: Cannot implicitly convert type 'int' to "byte， 


这 条 报错 信息 容易 引起 误解 。 根 据 它 的 提示 信息 ， 前 面 那 个 例子 也 
es 实际 上 编译 器 不 是 把 int 转 换 为 pyte， 而 是 把 300 转 
为 byte。 








. 显 式 类 型 转换 


元 组 字面 量 的 显 式 类 型 转换 遵循 和 隐 式 类 型 转换 相同 的 规则 ， 但 需 
要 对 每 个 元 素 都 添加 显 式 类 型 转换 。 满 足以 上 条 件 后 ， 就 可 以 把 元 
组 字面 量 转 换 成 元 组 类 型 了 ， 然 后 按照 正常 的 方式 来 转换 。 


提示 “C# 中 的 所 有 隐 式 类 型 转换 其 实 都 算是 显 式 类 型 转换 ， 
这 上 听 起 来 有 些 让 人 迷惑 。 可 以 把 它 理解 成 “不 论 是 显 式 的 还 是 
隐 式 的 ， 总 有 适用 于 各 元 象 的 转换 ”。 


回 到 之 前 的 (360，"text") 转 换 ， 它 存在 到 (byte，string) 的 显 式 类 
型 转换 ， 但 是 执行 该 表达 式 的 转换 需要 一 个 非 检查 的 上 下 文 ， 因 为 
编译 器 知道 300 这 个 值 超出 了 byte 的 表示 范围 。 一 个 更 实际 的 例子 
是 使 用 别处 的 一 个 int 变 量 : 











int x = 300; 
var tuple = ((byte, string)) (x, "text"); 


其 中 类 型 转换 部 分 ((byte，string)) 的 圆 括 号 看 似 见 余 了 ， 实 际 上 
并 没有 。 内 层 圆 括 号 是 元 组 类 型 所 需 的 ， 外 层 圆 括号 才 是 转换 所 需 
要 的 ， 如 图 11-4 所 示 。 














图 11-4 显 式 元 组 转换 括号 图 解 


在 我 看 来 ， 这 种 写法 虽 不 优雅 ， 但 起 码 它 的 功能 完成 了 。 一 个 更 为 
通用 和 简单 的 解决 办 法 是 ， 为 元 组 字面 量 中 每 个 元 素 表 达 式 添加 显 
式 类 型 转换 。 这 样 做 不 仅 可 以 完成 类 型 转换 ， 还 能 保证 字面 量 的 类 
型 推 烦 符合 要 求 。 例 如 前 面 的 例子 可 以 改写 为 : 


int x = 300; 
var tuple = ((byte) x, "text"); 


两 种 写法 其 实 是 等 价 的 ， 即 使 写成 对 整个 元 组 字面 量 进行 转换 ， 最 
后 编译 占 仍 会 把 它 变 成 针对 每 个 元 系 表 达 式 的 转换 ， 但 是 第 2 种 写 
法 明显 更 易 读 ， 表 意 更 清晰 : 从 int 到 byte 需 要 显 式 类 型 转换 ， 

而 string 可 以 保持 隐 式 类 型 转换 。 如 果 要 把 几 个 值 都 转换 成 元 组 类 
型 〈 不 使 用 类 型 推 新 ) ， 采 用 独立 转换 的 方式 可 以 明确 表达 出 哪些 
0 




















. 元 组 字面 量 转换 中 元 系 名 称 的 作用 


读者 可 能 已 经 注意 到 了 ， 本 节 并 没有 提 到 元 素 名 称 。 元 素 名 称 在 元 
组 字面 量 转换 中 几乎 不 起 任何 作用 。 更 重要 的 是 ， 不 具名 的 元 素 表 
达 式 可 以 转换 成 具名 元 素 表达 式 。 其 实 第 一 个 MinMax 方 法 实现 中 做 
过 这 种 转换 ， 只 是 当时 没有 提出 来 。 当 时 的 方法 声明 是 : 


static (int min, int max) MinMax(IEnumerable<int> Source ) 
方法 返回 时 : 
return (min, max); 


这 就 是 把 一 个 不 具名 3 的 元 组 字面 量 转换 成 (int min，int max)。 这 

















种 写法 显然 是 可 行 的 ， 还 很 方便 。 不 过 在 元 组 字面 量 转换 过 程 中 ， 
元 素 名 称 并 不 是 完全 没 用 。 当 元 组 字面 量 中 显 式 给 出 某 个 元 素 名 称 
时 ， 如 果 在 目标 元 组 类 型 中 没有 对 应 的 元 系 名 称 或 者 元 聚 名 称 不 匹 
配 ， 那 么 编译 器 会 发 出 警告 ， 丰 例如 下 : 


(int a, int b, int c, int, int) tuple = 
(a: 10, wrong: 20, 30, pointless: 40, 50); 


A 
致 ): 


(1) 元 组 字面 量 和 目标 元 组 类 型 给 出 相同 元 素 名 称 ; 
(2) 元 组 字面 量 和 目标 元 组 类 型 都 给 出 了 元 素 名 称 ， 但 名 称 不 同 ; 
(3) 目标 元 组 类 型 给 出 了 元 系 名 称 ， 但 元 组 字面 量 未 给 出 元 素 名 


称 ; 


(4) 目标 元 组 类 全 末 给 出 元 系 名 称 ， 但 元 组 字面 量 给 出 了 元 聚 名 
称 ; 


(5) 元 组 字面 量 和 目标 元 组 类 型 均 未 给 出 元 素 名 称 。 
显然 ， 第 2 个 和 第 4 个 会 导致 编译 发 出 警告 ， 编 详 结果 如 下 所 示 : 


warning CS8123: The tuple element name 'wrong' is ignored bec 
name is specified by the target type '(int a, int b, int 

warning CS8123: The tuple element name 'pointless' is ignored 
different name is specified by the target type '(int a, i 
int, int)' 


第 2 条 警告 信息 不 是 很 有 帮助 ， 因 为 目标 类 型 根本 没有 给 出 名 称 。 
希望 大 家 可 以 根据 警告 信息 找 出 问题 所 在 。 


这 种 方式 有 什么 用 吗 ? 当然 有 用 。 它 不 仅 适 用 于 在 一 条 语句 中 声明 
变量 和 构建 值 ， 也 适用 于 二 者 分 离 的 情况 。 假 设 代 码 清 单 11-1 中 的 
MinMax 方 法 很 长 ， 难 以 重 构 ， 那 么 应 该 返回 (min，max) 还 是 (max， 

min) 呢 ? 当然 ， 在 这 个 例子 中 ， 方 法 名 称 实 际 上 已 经 表明 返回 类 型 
的 顺序 了 ; 但 在 顺序 不 明确 的 情况 下 ， 就 需要 为 return 语 句 添加 元 
素 名 称 ， 这 样 可 以 起 到 校 验 的 效果 。 下 面 这 种 写法 就 不 会 发 出 编译 
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~ 
喇 : 


[一 


return (min: min, max: max); 


但 如 果 调 换 元 系 次 序 ， 则 两 个 元 素 部 会 收 到 编译 党 告 : 


return (max: max, min: min); <------ Warning CS8123 出 现 两 次 


请 注意 ， 这 种 行为 只 对 显 式 给 出 的 名 称 有 效 。 就 算 采 用 C# 7.1， 可 
以 通过 (max，min) 字 面 量 来 推 亲 元 素 名称， 如 果 要 把 它 转换 成 (int 
min，int max) 元 组 类 型 ， 编 译 器 也 不 会 发 出 编译 警告 。 


我 倾 问 于 通过 明确 的 代码 结构 来 尽 可 能 避免 这 种 额外 的 校 验 工作 。 
不 过 需要 的 时 候 ， 比 如 在 对 方法 做 精简 重 构 时 ， 有 这 样 一 项 特性 还 
征 会 带 来 一 些 便 利 。 


3 至 少 在 C# 7.0 中 如 此 。11.2.2 节 讲 过 ， 在 C#7.1 中 ， 可 以 推断 出 名 称 。 
11.3.3 ”元 组 类 型 之 间 的 转换 


熟悉 了 元 组 字面 量 转换 之 后 ， 对 于 元 组 类 型 转换 ， 不 管 是 隐 式 的 还 是 显 
式 的 ， 都 变 得 简单 了 ， 因 为 它们 的 转换 方式 相近 。 现 在 无 顷 考虑 表达 式 
的 问题 ， 只 需 考 虑 类 型 即 可 。 两 个 元 组 类 型 存在 隐 式 类 型 转换 的 条 件 
是 : 两 个 元 组 类 型 的 度 相 同 ， 且 对 应 元 素 都 存在 隐 式 类 型 转换 。 两 个 元 
组 类 型 存在 显 式 类 型 转换 的 条 件 是 : 两 个 元 组 类 型 的 度 相 同 ， 且 对 应 元 
7 下 面 以 (int，string) 为 例 展示 几 个 合法 的 转 



































var t1 = (300, "text"); <------ 推断 t1 的 类 型 为 (ijnt，string) 

(long, string) t2 = ti; <------ 从 (int，string) 到 (long，string ) 的 人 
(byte, string) t3 = t1， <------ 非法 : 不 存在 从 int 到 byte 的 隐 式 转换 
(byte, string) t4 = ((byte, string)) ti; <------ 从 (int, string) 
(object, object) t5 = ti; <------ 从 (int，string) 到 (object，object 
(string, string) t6 = ((string, string)) t1i; <------ 非法 : 从 int 到 s 


以 上 代码 的 第 4 行 ， 从 (int，string) 到 (byte，string) 的 显 式 类 型 转 
换 ， 其 结果 t4.Itemi1 的 值 为 44， 因 为 把 int 类 型 的 300 显 式 转 换 为 byte 类 
型 ， 结 果 就 是 44。 


与 元 组 字面 量 转换 不 同 ， 元 组 类 型 转换 时 ， 如 果 元 么 名 称 不 匹配 ， 古 不 











会 收 到 编译 警告 的 。 借 用 前 面 元 组 度 为 5 的 例子 : 只 需 把 元 组 字面 量 保 
i 
型 的 转换 了 。 


var Source = (a: 10, wrong: 20, 30, pointless: 40, 50); 
(int a, int b, int c, int, int) tuple = source; 








这 段 代码 编译 时 就 完全 不 会 触及 警告 信息 ， 不 过 元 组 类 型 转换 有 一 个 方 
和 
是 一 致 


1. 


元 组 类 型 一 致 性 转换 


C# 从 诞生 之 日 起 就 有 一 致 性 转换 的 概念 ， 不 过 随 厦 时 间 的 推移 ， 这 
个 概念 也 在 不 断 扩展 。 在 C# 7 之 前 ， 一 致 性 转换 的 规则 如 下 。 


同类 型 之 间 的 转换 是 一 致 性 转换 。 

object 类 型 和 dynamic 类 型 之 间 存 在 一 致 性 转换 。 

如 果 两 个 数组 的 元 素 类 型 之 间 存 在 一 致 性 转换 ， 那 么 这 两 个 数 
组 之 间 存 在 一 致 性 转换 ， 例 如 object[] 和 dynamic[] 之 间 存 在 一 
致 性 转换 。 

如 果 泛 型 的 类 型 实 参 之 间 存 在 对 应 的 一 致 性 转换 ， 那 么 泛 型 构 
建 后 类 型 也 存在 一 致 性 转换 ， 例 如 List<object> 和 
List<dynamic> 之 间 存 在 一 致 性 转换 。 


元 组 的 出 现 使 得 一 致 性 转换 家 族 再 添 一 员 : 两 个 度 相 同 的 元 组 类 
型 ， 当 每 对 元 素 类 型 都 存在 一 致 性 转换 时 ， 这 两 个 元 组 类 型 间 存 在 
一 致 性 转换 《不 考虑 元 素 名 称 ) 。 换 言 之 ， 以 下 几 个 类 型 存在 一 臻 
性 转换 《〈 双 辐 一 致 性 转换 ， 因 为 一 致 性 转换 必须 是 对 称 的 ) : 


O 〇 


O 〇 


O 〇 





oO 


o (int x, object y) 
o (int a, dynamic d) 
o (int, object) 


因为 一 致 性 转换 适用 于 构建 后 类 型 ， 同 时 元 组 元 素 类 型 可 以 是 构建 
后 类 型 ， 因 此 以 下 两 个 类 型 间 存 在 一 致 性 转换 : 





o Dictionary<string, (int, List<object>)> 
o Dictionary<string, (int index, List<dynamic>values)> 





文 持 构 建 后 类 型 对 于 元 组 的 一 致 性 转换 来 说 很 重要 。 如 果 (int， 
int) 和 (int x，int y) 之 间 能 进行 转换 ， 但 IEnumerable<(int， 
int)> 和 IEnumerable<(int x，int y) 之 间 不 行 ， 或 者 反 过 来 的 话 ， 
就 很 烦人 了 。 

一 致 性 转换 对 于 重 载 方 法 来 说 同样 重要 。 重 载 方法 不 能 仅 通 过 返回 
类 型 不 同 来 区 分 ， 也 不 能 仅 通 过 可 以 做 一 致 性 转换 的 参数 类 型 来 区 
分 。 例 如 在 同一 个 类 中 不 能 同时 编写 以 下 两 个 方法 : 

public void Method((int, int) tuple) {} 

public void Method((int x, int y) tuple) {} 

否则 会 得 到 如 下 编译 错误 : 


error CSo111: Type 'Program' already defines a member called 
the same parameter types 


从 C# 语 言 的 角度 讲 ， 这 两 个 参数 类 型 并 不 严格 一 致 。 不 过 ， 如 条 把 
这 里 的 报错 信息 细 化 精准 到 一 致 性 转换 上 ， 就 会 让 人 难以 理解 了 。 


如 果 感 觉 一 致 性 转换 的 官方 定义 难以 理解 ， 这 里 有 一 种 简单 的 方 
式 : 如 果 在 执行 期 两 个 类 型 无 法 区 分 ， 它 们 就 属于 一 致 性 类 型 ， 
11.4 节 会 详 述 。 





2. 缺少 泛 型 协 变 
学 习 了 一 致 性 转换 之 后 ， 读 者 可 能 希望 能 够 在 接口 和 委托 类 型 中 应 
用 元 组 类 型 和 泛 型 型 变 ， 可 惜 事与愿违 ， 泛 型 型 变 只 能 用 于 引用 类 
型 ， 而 元 组 类 型 是 值 类 型 ， 比 如 下 面 这 段 代 码 感觉 是 可 行 的 ; 


IEnumerable<(string, string)> stringPairs 
IEnumerable<(object, object)> objectPairs 


实则 不 然 。 虽 然 在 实践 中 这 种 需求 不 常见 ， 但 还 是 布 望 读 者 不 要 因 
此 而 失望 。 


11.3.4 ”类 型 转换 的 应 用 
了 解 了 元 组 类 型 转换 的 用 法 之 后 ， 就 要 考虑 这 些 转换 的 使 用 场景 。 这 一 





new (string, stri 
stringPairs; 








点 主要 取决 于 如 何 使 用 元 组 。 如 果 是 在 茶 个 方法 中 使 用 元 组 ， 或 者 茶 个 
私有 方法 返回 元 组 ， 然 后 由 同类 型 下 的 其 他 方法 来 使 用 ， 几 乎 很 少 会 涉 
及 类 型 转换 问题 。 我 们 只 需要 一 开始 就 选择 正确 的 类 型 ， 可 能 只 需要 在 
构建 初始 值 时 在 某 个 元 组 字面 量 内 部 做 转换 。 


如 果 是 internal 或 者 公共 方法 接收 或 者 返回 元 组 ， 就 有 可 能 需要 转换 元 组 
类 型 了 ， 因 为 我 们 将 失去 对 于 元 组 元 素 类 型 的 掌控 。 元 组 类 型 的 使 用 范 
围 越 广 ， 在 具体 使 用 场景 中 就 越 不 可 能 保持 最 初 的 类 型 。 


11.3.5 ”继承 时 的 元 素 名 称 检查 


元 素 名 称 在 进行 类 型 转换 时 并 不 重要 ， 但 是 在 涉及 继承 时 编译 器 对 名 称 
有 要 求 。 如 有 果 茶 个 子 类 或 者 接口 实现 类 的 成 员 中 出 现 元 组 ， 那 么 元 组 中 
的 元 又 名 称 必 须 和 原始 元 组 名 称 完全 一 致 。 原 始 元 组 元 素 具 名 时 ， 要 保 
持 名 称 一 致 ， 如 果 不 具 名 ， 继 承 类 或 者 实现 类 中 的 元 组 元 素 也 必须 不 具 
ee 





























考虑 如 下 ISample 接 口 及 其 奇 干 实 现 方法 ISample.Method (当然 ， 这 些 方 
法 都 应 该 存在 于 独立 的 类 中 ) : 


interface ISample 


void Method((int x, string) tuple); 








} 

public void Method((string x, object) tuple) {} <------ 音 误 的 类 型 
public void Method((int, string) tuple) {} <------ 第 1 个 元 素 缺 少 名 称 
public void Method((int x, string extra) tuple) {} <------ 第 2 个 元 
public void Method((int wrong, string) tuple) {} <------ 第 1 个 元 素 : 
public void Method((int x, string, int) tuple) {} <------ 类 型 个 数 ; 
public void Method((int x, string) tuple) {} <------ 合法 





这 个 例子 只 展示 了 接口 实现 的 要 求 ， 但 同样 的 要 求 对 于 和 窗 新 基 类 的 方法 
也 适用 。 男 外 ， 这 个 例子 虽然 只 展示 了 参数 的 用 法 ， 但 该 要 求 也 适用 于 
返回 值 ， 因 此 需要 注意 : 对 于 接口 成 员 或 者 virtual/abstract 类 成 员 中 
元 组 元 素 类 型 名 称 的 增加 、 删 除 和 修改 都 属于 破坏 性 更 改 。 在 对 公共 

API 做 此 类 修改 时 一 定 要 慎重 考虑 ! 


说 明 有 时 这 个 要 求 会 出 现 不 一 致 性 : 在 实现 接口 或 者 覆盖 方法 

















时 ， 编 译 器 并 不 会 考虑 类 的 作者 可 能 会 修改 方法 参数 名 称 ， 如 果 调 
用 方 修改 了 代码 中 指向 的 是 接口 还 是 实现 ， 那 么 这 种 可 以 指定 实 参 
名 称 的 能 力 会 造成 问题 。 我 认为 如 果 C# 语 言 设计 团队 重新 设计 ， 可 
能 会 禁止 该 操作 。 


C# 7.3 为 元 组 又 增添 了 一 项 语言 特性 ;使 用 -= 运算 符 和 != 运 算 符 比较 元 
组 。 





11.3.6 ”等 价 运算 符 与 不 等 价 运算 符 (C#7.3) 


11.4.5 慷 会 介绍 ，CLR 对 于 元 组 值 的 表示 上 自 始 就 通过 Equals 方 法 文 持 等 
价 操作 ， 但 是 并 没有 重 载 == 运 算 符 和 != 运 算 符 。 不 过 从 C# 7.3 开 始 ， 编 
译 絮 吏 为 存在 一 致 性 转换 的 元 组 类 型 提供 了 元 组 == 和 != 的 实现 。 抛 开 
一 致 性 转换 的 其 他 方面 不 谈 ， 这 意味 着 元 素 名 称 不 重要 。 ) 


编译 如 将 == 运 算 符 扩 展 到 元 素 级 别 的 == 操 作 。 它 会 对 每 一 对 元 素 值 执 
行 == 操 作 (!= 运 算 符 同 理 ) 。 代 码 示例 如 下 。 


代码 清单 11-8 ”等 价 运算 符 与 不 等 价 运算 符 











var ti = (x: "x", y: "y", Zz: 1); 
var t2 二 (xX. "y", 于) 二 
Console ,WriteLine(t1 == t2); <------ 等 价 运 算 符 





Console.writeLine(t1.Item1 == t2.Item1 && (本 行 及 以 下 2 行 ) 编译 器 生成 
t1.Item2 == t2.Item2 && 
t1.Item3 == t2.Item3); 


Console.writeLine(t1 != t2); <------ 不 等 价 运算 符 

Console .writeLine(t1i.Item1 != t2.Item1 || (本 行 及 以 下 2 行 ) 编译 器 生成 上 
t1.Item2 != t2.Item2 || 
ti.Item3 != t2.Item3); 


代码 清单 11-8 展 示 了 两 个 元 组 〈 一 个 具名 ， 一 个 不 具名 ) ， 分 别 使 用 等 
价 运算 符 与 不 等 价 运算 符 进行 比较 。 每 个 比较 操作 后 面 还 展示 了 编译 器 
为 该 操作 生成 的 代码 。 需 要 重点 关注 的 是 : 生成 的 代码 使 用 元 素 类 型 本 
喘 所 提供 的 重 载 方法 。CLR 也 可 以 不 使 用 反射 来 提供 相同 的 功能 ， 不 过 
交 由 编译 器 处 理会 更 合适 。 


前 面 深入 讲解 了 元 组 使 用 规则 。 像 在 类 型 推 新 中 如 何 填 充 元 素 名 称 这 样 

















的 细节 ， 语 言 规范 中 解释 得 很 清楚 。 本 书 对 某 些 技术 细节 的 讨论 自 有 所 
限 。 尺 管 所 讲 内 容 是 以 应 付 日 常 工作 的 使 用 ， 但 是 深入 友 据 CLR 对 元 组 
的 支持 ， 看 看 编译 器 如 何 把 这 些 规则 应 用 于 江 当 中 ， 有 助 于 我 们 更 好 地 
理解 和 应 用 元 组 这 项 特性 。 


关于 元 组 ， 己 经 探讨 得 很 细致 了 。 硕 望 读者 可 以 趁 热 打铁 ， 动 手 做 一 些 
关于 元 组 特性 的 实战 练习 ， 因 为 接 下 来 要 讲解 元 组 的 实现 原理 了 。 





11.4 ”CLR 中 的 元 组 


从 理论 上 说 ，C# 语 言 和 .NET 并 不 存在 绑 定 关系 ， 但 我 见 过 的 每 个 实现 
都 在 尽量 与 .NET Framework 接 近 ， 即 便 是 提前 编译 过 并 且 在 非 桌面 终端 
设备 上 运行 。C# 语 言 规范 对 最 终 环境 有 明确 规定 ， 包 括 哪些 类 型 可 用 。 
在 编写 本 书 时 ，C# 7 的 编程 规范 还 没有 问世 ， 当 其 推出 时 ， 其 中 押 要 求 
的 使 用 元 组 的 类 型 都 是 本 节 所 讲授 的 内 容 。 


在 实现 匿名 类 型 时 ， 编 译 器 需要 为 该 程序 集中 每 个 单独 的 属性 名 序列 都 
创建 一 个 新 类 型 ， 元 组 特性 则 不 然 。 编 译 器 不 需要 为 元 组 创建 额外 的 类 
型 ， 而 会 从 framework 中 取 用 一 个 新 的 类 型 集合 ， 下 面 详细 阐述 。 





11.4.1 引入 system.ValueTuple<.. .> 


C# 7 的 元 组 类 型 是 通过 System.ValueTuple 类 型 家 族 实现 的 。 这 些 类 型 位 
于 system.ValueTuple.dl11 程 序 集 ， 该 程序 集 属 于 .NET Standard 2.0 的 一 
部 分 ， 以 前 的 发 行 版 本 中 不 存在 。 如 果 目 标 版 本 是 某 些 较 早 的 
frameworkk， 则 需要 通过 NuGet 包 添加 对 system.ValueTuple 的 依赖 。 


ValueTuple 结 构 体 共有 9 个 定义 ， 其 泛 型 度 从 0~8 分 别 为 : 





System.ValueTuple ( 非 泛 型 ) 
System.ValueTuple<T1> 

System.ValueTuple<T1, T2> 
System.ValueTuple<T1, T2, T3> 
System.ValueTuple<T1, T2, T3, T4> 
System.ValueTuple<T1, T2, T3, T4, TS5> 
System.ValueTuple<T1, T2, T3, T4, T5, T6> 
System.ValueTuple<T1, T2, T3, T4, T5, T6, T7> 


e@ System.ValueTuple<T1, T2, T3, T4, T5, T6, T7, TRest> 


暂时 忽略 前 两 个 以 及 最 后 一 个 结构 体 ， 留待 11.4.7 节 和 11.4.8 节 讨论 。 目 
前 只 讨论 泛 型 度 在 2~7 的 定义 〈 这 几 个 比较 常用 ) 。 


valueTuple<,. .> 类 型 和 前 面 元 组 类 型 十 分 相似 : 它 是 具有 公共 字段 的 值 
类 型 。 其 字段 名 称 为 Item1、Item2、...... 、Item7。 度 为 8 的 元 组 最 后 一 
个 字段 名 为 Rest。 


在 使 用 C# 元 组 类 型 时 ， 它 都 会 被 映射 为 某 个 valueTuple<.. .> 类 型 。 当 
C# 元 组 类 型 不 包含 任何 元 素 名 称 时 ， 该 映射 过 程 很 直接 ， 例 如 (int， 
string，byte) 被 映射 为 valueTuple<int，string，byte>。 那 么 C# 元 组 
类 型 中 的 可 选 元 素 名 称 如 何 上 映射 呢 ? 泛 型 类 型 只 有 在 类 型 形 参 时 才 是 泛 
我 们 无 法 为 两 个 构建 类 型 赋予 不 同 的 字段 名 ， 编 译 器 如 何 处 理 这 种 
情况 呢 ? 


11.4.2 ”处 理 元 素 名 称 


实际 上 ， 为 了 能 够 把 C# 元 组 类 型 映射 到 cLR valueTuple<.. .> 类 型 ， 编 
译 器 会 忽略 元 素 名 称 。 虽 然 从 C#i 语 言 的 角度 看 ，(int，int) 和 (int x， 
int y) 是 不 同 的 类 型 ， 但 它们 都 会 被 映射 到 valueTuple<int，int> 类 
型 。 之 后 编译 器 会 把 所 有 使 用 元 素 名 称 之 处 都 映射 到 ItemN 这 样 的 名 称 
上 0 转换 后 的 类 型 只 供 
CLR 5 











图 11-5 ”编译 器 把 元 素 类 型 蔡 换 成 valueTuple 


请 注意 图 11-5 的 下 半 部 分 ， 元 组 元 素 的 名 称 都 消失 了 。 这 种 局 部 变量 仅 
在 编译 时 有 效 ; 而 在 执行 期 ， 只 有 PDB 文 件 会 跟 踊 这 些 名 称 用 于 调试 。 
那么 在 方法 之 外 使 用 的 那些 元 又 名称 又 会 如 何 处 理 呢 ? 


1. 





元 数据 中 的 元 系 名 称 


回想 本 章 多 次 使 用 的 MinMax 方 法 。 假 设 将 其 设 为 公共 方法 ， 用 作 

LINQ to Objects 的 补充 方法 。 如 前 所 述 ，CLR 的 方法 返回 类 型 无 法 

填充 原先 的 元 素 名 称 。 这 样 一 来 ， 如 果 不 能 保留 元 素 名 称 ， 可 读 性 

就 会 变 差 。 好 在 编译 器 可 以 处 理 这 种 情况 一 一 使 用 attribute，CLR 

人 
ys 


束 本 例 来 说 ， 编译 器 会 使 用 一 个 名 为 TupleElementNamesAttribute 
的 attribute (很 多 类 似 的 attribute 位 于 
System.Runtime.CompilerServices 命 名 空间 下 ) ， 来 把 元 素 名 称 编 
0 
方法 声明 : 


[return: TupleElementNames(new[] {"min", "max"})] 








public static ValueTuple<int, int> MinMax(IEnumerable<int> nu 


不 过 C# 7 不 支持 这 样 的 代码 ， 编 译 占 会 报错 ， 提 示 应 当 直 接 使 用 元 
组 语法 。 我 们 可 以 使 用 C# 6 编译 器 来 编译 ， 得 到 的 程序 集 可 用 于 C# 
7， 这 样 返回 的 元 组 元 素 名 称 就 可 以 访问 了 。 


如 果 存在 嵌 套 元 组 类 型 ， 这 种 方式 会 变 得 更 复杂 ， 不 过 我 们 几乎 不 
需要 自己 直接 翻译 这 些 attribute， 而 只 需要 知道 存在 这 种 情况 ， 并 
且 知 道 元 素 名 称 如 何 与 局 部 变量 之 外 的 部 分 交换 信息 。 即 便 是 私有 
成 员 ，C# 编 译 器 也 会 生成 这 些 attribute， 哪 怕 最 终 可 能 用 不 到 。 如 
果 将 所 有 成 员 (无 论 以 何 修饰 符 修 饰 、 都 按照 同等 方式 处 理 ， 在 设 
计 上 会 相对 简单 。 























. 执行 期 不 存在 元 素 名 称 


元 组 类 型 在 执行 期 没有 元 素 名 称 。 如 果 对 某 个 元 组 值 调 
用 GetType()， 将 得 到 一 个 valueTuple<.. .> 类 型 ， 包 含 对 应 的 各 个 
元 素 类 型 ， 但 源码 所 有 的 元 素 名 称 都 将 消失 。 如 果 我 们 调试 并 且 步 
进 代码 ， 仍 能 看 到 元 素 名 称 ， 那 是 因为 调试 器 使 用 了 额外 的 信息 获 
取 了 原始 的 元 素 名 称 ， 而 CLR 无 法 直接 知晓 这 些 信息 。 


说 明 Java 开 发 人 员 可 能 比较 熟悉 这 种 机 制 。 它 类 似 于 Java 中 
处 理 泛 型 的 类 型 信息 ， 这 些 类 型 信息 也 不 会 在 执行 期 出 现 。 在 
Java 中 ， 没 有 ArrayList<Integer> 对 象 和 ArrayList<String> 对 
象 ， 都 称 ArrayList 对 象 。 实 践 表 明 ， 这 是 Java 语 言 的 痛 点 。 好 
在 元 组 的 元 素 名 称 并 不 像 泛 型 类 型 实 参 那样 重要 ， 和 希望 该 机 制 
不 要 演变 出 Java 类 型 信息 那样 的 问题 。 


元 素 名 称 只 存在 于 C# 语 言 ， 而 不 存在 于 CLR， 那 么 类 型 转换 呢 ? 











11.4.3 ”元 组 类 型 转换 的 实现 


ValueTuple 家 族 中 的 类 型 并 不 提供 任何 CLR 层 面 的 转换 机 制 ， 因 为 C# 语 
言 所 提供 的 类 型 转换 无 法 通过 类 型 信 乱 来 表示 。C# 编 译 右 会 根据 需要 创 
建 一 个 新 值 ， 然 后 对 每 个 元 素 单 独 进行 转换 。 示 例如 下 : 一 个 隐 式 类 型 
转换 (使 用 从 int 到 1long 的 隐 式 类 型 转换 ) 和 一 个 显 式 类 型 转换 (使 用 
从 ;int 到 byte 的 显 式 类 型 转换 ) 。 


(int, string) t1 = (300, "text"); 
(long, string) t2 t1; 
(byte, string) t3 ((byte, string)) ti1; 


编译 占 会 生成 如 下 代码 : 


var tl = new ValueTuple<int, string>(300, "text"); 
var t2 = new ValueTuple<long, string>(t1.Item1i, t1.Item2); 
var t3 = new ValueTuple<byte, string>((byte) ti.Itemi, t1.Item2)) 


这 个 例子 只 展示 了 元 组 类 型 之 间 的 转换 ， 元 组 字面 量 到 元 组 类 型 之 间 的 
转换 机 制 与 之 完全 一 致 : 任何 元 素 表达 式 到 目标 元 素 类 型 的 转换 都 只 会 


成 为 valueTuple<.. .> 构造 器 的 一 部 分 。 


关于 编译 器 如 何 处 理 元 组 语法 的 内 容 已 经 介绍 完毕 ， 不 过 
ValueTuple<.. .> 类 型 还 提供 了 很 多 易 用 的 功能 。 由 于 该 类 型 的 通用 度 较 
高 ， 因 此 功能 相对 有 限 。 该 类 型 的 Tostring() 方 法 的 输出 可 读 性 很 强 ， 
还 有 多 个 用 于 元 组 比较 的 选项 ， 下 面 来 看 看 。 








11.4.4 元 组 的 字符 串 表 示 


元 组 的 字符 串 表 示 看 上 去 与 C 奴 原 码 中 的 元 组 字面 量 类 似 : 由 小 括号 包 
围 、 由 逗号 分 隔 的 一 组 值 。 元 组 的 字符 串 表示 并 不 提供 任何 优化 的 控制 
选项 : 如 果 使 用 (DateTime，DateTime) 元 组 来 表示 某 个 时 间 间 隅 ， 无 法 
传 入 一 个 格式 串 来 指示 日 期 格式 化 。Tostring() 方 法 实际 上 对 每 个 
非 nul1 元 素 调用 Tostring() 方 法 ， 对 于 nul11 元 素 则 返回 空 串 。 


再 次 提醒 : 在 执行 期 元 组 元 系 的 名 称 是 不 可 见 的 ， 因 此 Tostring() 方 法 
的 调用 结果 中 不 会 出 现 元 素 名 称 。 该 特点 使 得 元 组 的 Tostring() 方 法 没 
有 匿名 类 型 的 相同 方法 用 途 广 泛 ， 不 过 如 有 果 需 要 打印 同一 类 型 的 多 个 元 
组 值 ， 也 不 会 希望 结果 中 出 现 元 系 名 称 ， 下 面 举例 说 明 : 


var tuple = (x: (string) null, y: "text", z: 10); <------ 将 null 转 
Console .WriteLine(tuple,.ToString()); <------ 向 终端 打印 元 组 值 


这 上段 代码 的 输出 结果 如 下 : 
(, text, 10) 


其 中 显 式 调用 Tostring() 则 在 排除 其 他 因 系 的 干扰 。 如 果 直 接 使 














用 console.writeLine(tuple)， 结果 相同 。 


元 组 字符 串 表 示 对 于 诊断 目的 来 说 大 有 用 处 ， 不 过 最 好 不 要 将 其 直接 呈 
献 给 终端 用 户 ， 人 否则 需要 指定 格式 信息 ， 并 且 预 先 处 理 好 nul1 值 。 


11.4.5 “一般 等 价 比较 和 排序 比较 


ValueTuple<.. .> 类 型 都 实现 了 IEquatable<T> 和 IComparable<T> 接 口 ， 其 
中 T 与 元 组 元 素 类 型 保持 一 致 。 例 如 valueTuple<T1，T2> 实 现 了 
IEquatable<ValueTuple<T1, T2>> 和 IComparable<valueTuple<T1,， T2>> 


两 个 接口 。 


每 个 类 型 还 实现 了 非 泛 型 的 Icomparable 接 口 ， 并 且 重 写 了 
object.Equals(object) 方 法 : 如 果实 参 类 型 与 调用 Equals(object) 的 实 
例 类 型 不 同 ， 那 么 Equals (object ) 将 返回 false， 并 

且 compareTo(object) 会 抛 出 ArgumentException,， 每 个 方法 都 委托 了 各 
自 的 IEquatable<T> 或 者 Icomparable<T>。 


等 价 比 较 操作 对 每 个 元 素 都 调用 其 默认 的 等 价 比较 器 。 类 似 地 ， 元 素 散 
列 值 也 使 用 了 默认 的 等 价 比较 器 ， 然 后 这 些 散 列 值 结合 成 一 个 元 组 的 整 
体 散 列 值 。 排 序 比较 也 是 按 元 素 进 行 的 ， 排 在 前 面 的 元 素 在 比较 中 权重 
大 于 排 在 后 面 的 元 素 ， 例 如 (1，5) 小 于 (3，2)。 


有 了 这 些 比较 操作 ， 在 LINQ 中 使 用 元 组 就 更 简单 了 。 假 设 有 一 个 (int， 
int) 类 型 的 集合 ， 用 于 表示 (x，y) 坐 标 值 。 我 们 可 以 使 用 熟悉 的 LINQ 操 
作 来 碍 找 不 重合 的 点 ， 然 后 将 它们 排序 ， 代 码 如 下 。 

代码 清单 11-9 得 找 非 重合 点 集 并 排序 


var points = new[] 

















(1, 2), (10, 3), (-1, 5), (2, 1), 
(10, 3), (2, 1), (1, 1) 


了 
var distinctPoints = points.Distinct(); 
Console.writeLine($"{distinctPoints.Count()} distinct points"); 
Console.WwriteLine("Points in order:"); 
foreach (var point in distinctPoints.OrderBy(p => p)) 


Console.writeLine(point); 


} 


调用 Distinct() 方 法 意味 着 在 输出 结果 中 (2，1) 只 会 出 现 一 次 。 等 价 比 
较 以 元 素 为 单位 ， 这 意味 着 (2，1) 与 (1，2) 不 等 价 。 


由 于 元 组 中 第 一 个 元 素 的 排序 权重 最 高 ， 因 此 这 些 点 将 按照 x 坐标 进行 
排序 : 如 果 参 与 比较 的 点 的 x 坐标 相同 ， 将 按照 y 坐标 进行 排序 ， 结 果 
如 下 所 示 : 


5 distinct points 
Points in order: 
(-1, 5) 
(1, 1) 
(1, 2) 
(2, 1) 
(10, 3) 


普通 的 比较 操作 无 法 对 每 个 特定 元 素 进行 比较 。 我 们 可 以 为 元 组 类 型 创 
建 自己 的 IEqualityCcomparer<T> 或 者 Icomparer<T> 实 现 ， 不 过 这 时 需要 
考虑 可 否 创 建 一 个 特定 类 型 ， 而 不 是 用 元 组 来 表示 。 有 时 使 用 结构 化 比 
较 操作 可 能 更 人 简单。 


11.4.6 ”结构 化 等 价 比较 和 排序 比较 


除了 普通 的 IEquatable 接 口 和 ICcomparable 接 口 ， 每 个 valueTuple 结 构 体 
还 显 式 地 实现 了 IStructuralEquatable 接 口 和 IStructuralcomparable 接 
口 。 这 两 个 接口 源 自 .NET 4.0， 数 组 和 不 可 变 类 的 Tuple 家 族 都 实现 了 二 
者 。 我 本 人 还 从 未 用 过 这 两 个 接口 ， 但 这 并 不 意味 着 它们 的 可 用 性 低 。 

0 
元 素 的 比较 : 


public interface IStructuralEquatable 








bool Equals(Object, IEqualityComparer ) ， 
int GetHashCode(IEqualityComparer ); 


public interface IStructuralComparable 


int CompareTo(Object, IComparer); 


这 两 个 接口 背后 的 设计 思想 是 : 证 组 合 型 对 象 可 以 通过 给 定 的 比较 器 来 
完成 比较 或 排序 操作 。valueTuple 所 实现 的 普通 泛 型 比较 属于 静态 类 型 
安全 的 比较 ， 但 不 够 灵活 ; 结构 化 比较 器 更 灵活 ， 但 在 类 型 安全 上 有 所 
不 足 。 代 码 清单 11-10 通 过 string 类 型 展示 了 使 用 不 区 分 大 小 写 的 比较 
器 完 成 结构 化 比较 操作 。 


代码 清单 11-10 ”使 用 不 区 分 大 小 的 比较 融 进 行 结构 化 比较 


static void Main() 

















var Ab = ("A",，"b"); (本 行 及 以 下 3 行 ) 变量 名 称 用 于 反映 值 的 内 容 
var aB 二 ("a", "B"); 
var aa 二 (a "a" ); 
var ba 二 ("b", "a" ); 


Compare(Ab，aB); (本 行 及 以 下 2 行 ) 执行 比较 操作 
Compare(aB, aa); 
Compare(aB, ba); 


static void Compare<T>(T x, T y) 
where T : IStructuralEquatable, IStructuralComparable 





var comparison = x.CompareTo( (本 行 及 以 下 3 行 ) 不 区 分 大 小 写 的 排序 和 
y, StringComparer.OrdinalIignoreCase); 

var edual = x.Equals( 
y, StringComparer.OrdinalIignoreCase); 


Console .writeLinel( 
$"{x} and {y} - comparison: {comparison}; equal: {equal}" 








执行 结果 显示 : 比较 确实 是 成 对 进行 的 ， 并 且 比 较 时 不 区 分 大 小 写 。 


(A, b) and (a, B) - comparison: 0; equal: True 
(a, B) and (a, a) - comparison: 1; equal: False 
(a, B) and (b, a) - comparison: -1; equal: False 


这 种 比较 方式 的 好 处 在 于 : 比较 右上 只 负责 对 单个 元 素 执行 比较 操作 ， 然 
后 由 元 组 目 身 的 实现 将 每 个 比较 操作 代理 给 比较 硕 。 这 个 过 程 有 点 像 
LINQ: 针对 个 体 元 素 表 达 的 操作 ， 但 最 后 将 它 作 用 于 整个 集合 。 


如 果 需 要 操作 的 元 组 中 的 元 系 痢 是 同一 类 型 ， 这 种 比较 没有 问题 。 如 果 
需要 对 包含 不 同 元 系 类 型 的 元 组 做 结构 化 比较 ， 例 如 (string，int， 








double) 这 样 的 元 组 值 ， 束 需要 确保 比较 器 可 以 正确 处 理 字 符 串 、 整 型 
和 双 精 度 浮 点 数 的 比较 ， 不 过 每 次 比较 只 需要 比较 两 个 同类 型 的 值 。 
而 ValueTuple 的 实现 依然 只 允许 具有 相同 类 型 实 参 的 元 组 进行 比较 。 如 
果 对 (string，int) 和 (int，string) 执 行 比较 操作 ， 那 么 在 实际 比较 之 
前 ， 立 即 会 有 异常 抛 出 。 此 类 比较 器 不 在 本 书 的 探讨 范围 内 。 如 果 读 者 
需要 在 产品 代码 中 实现 这 样 一 个 比较 器 ， 建 议 以 
compoundEqualityComparer 为 基础 开始 构建 。 


对 于 度 在 2~7 的 valueTuple<.. .> 类 型 就 介绍 到 这 里 。11.4.1 节 说 过 还 要 
讨论 另外 3 个 类 型 ， 首 先 介绍 valueTuple<T1> 和 valueTuple<T1，T2，T3， 
T4，T5，T6，T7，TRest> 这 两 个 类 型 ， 它 们 的 行为 更 接近 我 们 的 预期 。 


11.4.7 独 素 元 组 和 巨型 元 组 


C# 团 队 内 部 把 只 有 一 人 元 素 的 元 组 (ValueTuple<T1>) 称 为 独 素 元 组 
Cwomple) 。 这 种 元 组 不 能 通过 上 自身 的 元 组 语法 来 创建 ， 但 是 可 以 作 
为 其 他 元 组 的 一 部 分 而 存在 。 前 面 讲 过 ， 泛 型 valueTuple 结 构 体 最 多 文 
持 8 个 类 型 形 参 。 如 果 要 创建 多 于 8 个 元 素 的 数组 ， 编 译 器 该 如 何 处 理 
呢 ? 编译 器 首先 会 使 用 度 为 8 的 valueTuple<,. . .> 作为 模板 ， 将 前 7 个 元 素 
和 字面 量 值 进行 对 应 ， 然 后 把 最 后 一 个 元 组 作为 散 套 的 元 组 类 型 用 于 表 
示 剩 余 元 素 。 对 于 一 个 度 为 8 的 int 类 型 元 素 的 元 组 ， 其 相关 类 型 如 下 : 


ValueTuple<int, int, int, int, int, int, int, ValueTuple<int>> 


以 上 代码 中 加 粗 的 部 分 就 是 独 素 元 组 。 度 为 8 的 valueTuple<. , .> 就 是 为 
此 而 设计 的 ， 最 后 一 个 实 参 TRest 被 限制 为 值 类 型 ， 而 且 11.4.1 节 开头 也 
说 过 ， 不 存在 Item8 这 个 字段 ， 代 之 为 Rest 字 段 。 

对 于 度 为 8 的 valueTuple<.. .> 来 说 ， 用 最 后 一 个 元 素 表 示 更 多 元 素 而 非 
最 后 单个 元 素 以 避免 蚊 义 是 很 重要 的 ， 例 如 以 下 元 组 类 型 : 


ValueTuple<A, B, C, D, E, F, G, ValueTuple<H, I>> 


它 可 以 是 C# 语 法 类 型 的 度 为 9 的 (A，B，c，D，E，F，6G ,H，I)， 或 者 是 
度 为 8 的 (A，B,，Cc，D，E, F,，6，(H,I))， 最 后 一 个 是 一 个 元 组 类 型 。 


开发 人 员 无 须 操 心 这 些 ， 因 为 C# 编 译 器 会 丛 我 们 处 理 所 有 ITtemx 的 名 
称 ， 并 且 与 元 又 个 数 无 关 ， 与 使 用 元 组 语法 还 是 显 式 使 用 valueTuple 也 



































无 天 ， 例 如 以 下 长 元 组 : 


var tuple = (1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 1 
Console.writeLine(tuple.Item16); 


这 上段 代码 是 完全 合法 的 ， 但 编译 器 会 把 tuple.Item16 表 达 式 转换 
为 tuple.Rest.Rest.Item2。 如 果 需 要 使 用 真实 的 字段 名 称 ， 也 完全 没有 
问题 ， 不 过 不 建议 这 么 做 。 








11.4.8” 非 泛 型 valueTuple 结 构 体 


如 条 独 系 元 组 听 起 来 比较 奇怪 ， 那 么 无 素 元 组 “nuple， 非 泛 型 、 无 元 

素 的 元 组 ) 似乎 更 没有 意义 了 。 读 者 可 能 党 得 非 泛 型 的 ValueTuple 应 该 
是 静态 类 ， 就 像 非 江 型 的 Nullable 类 一 样 ， 但 它 依然 是 结构 体 ， 类 似 于 
其 他 元 组 ， 只 不 过 没有 任何 数据 。 该 结构 体 实现 了 本 节 提 到 的 所 有 接 

口 ， 任 何 无 素 元 组 和 其 他 无 素 元 组 都 是 等 价 的 《在 等 价 比较 或 者 排序 比 
较 中 ) 。 显 然 ， 无 素 元 组 之 间 没 有 任何 区 别 。 


该 类 型 还 包含 用 于 创建 valueTuple<.. .> 的 静态 方法 ， 在 元 组 字面 量 不 可 
用 时 ， 这 些 静 态 方 法 能 够 派 上 有 用场。 例如 使 用 C# 6 或 者 其 他 没有 内 建 元 
组 文 持 的 语言 中 使 用 元 组 ， 并 且 需 要 对 元 素 类 型 进行 类 型 推 新 ， 那 么 这 
些 静 态 方 法 将 是 主力 方法 。 (请 牢记 ， 当 调用 构造 器 时 ， 总 是 需要 指定 
所 有 类 型 实 参 ， 这 一 点 比较 烦 玉 。) 例如 要 在 C# 6 中 使 用 类 型 推 灯 来 构 
建 (int，int) 元 组 ， 代 人 码 如 下 所 示 : 


var tuple = ValueTuple.Create(5, 10); 


C# 设 计 团 队 表 示 无 素 元 组 将 来 可 能 会 在 模式 匹配 和 分 解 特 性 中 占有 一 席 
之 地 ， 但 目前 只 用 作 占 位 符 。 














11.4.9 ”扩展 方法 


System.TupleExtensions 静 态 类 和 system.vValueTuple 类 型 由 同一 个 程序 
集 提 供 。 访 静态 类 包含 了 system.Tuple 和 System.ValueTuple 类 型 的 一 些 
扩展 方法 。 这 些 扩展 方法 分 为 3 类 : 


@ Deconstruct 负 责 Tuple 类 型 的 扩展 ; 
e TovalueTuple 负 责 Tuple 类 型 的 扩展 ; 


@ ToTuple 负 责 VvalueTuple 类 型 的 扩展 。 


每 种 扩展 方法 都 会 根据 前 面 提 到 的 泛 型 度 进行 21 次 重 载 ， 以 便 处 理 8 及 
其 以 上 上 度 的 情况 。 第 12 章 会 介绍 Deconstruct 方 法 。TovalueTuple 和 
ToTuple 方 法 符合 我 们 的 直观 预期 : 它们 负责 .NET 4.0 不 可 变 的 引用 类 型 
元 组 和 新 的 可 变 值 类 型 元 组 之 间 的 转换 。 这 两 个 方法 主要 用 于 处 理 遗 留 
代码 中 使 用 Tuple 的 情况 。 


以 上 就 是 我 能 想到 的 关于 CLR 元 组 实现 的 所 有 有 价值 的 类 型 了 ， 下 面 了 


解 其 他 一 些 特性 。 当 需要 使 用 元 组 时 ， 元 组 特性 只 是 众多 工具 之 一 ， 而 
且 并 不 适用 于 所 有 场景 。 


11.5 “元 组 的 替代 品 


希望 读者 不 要 觉得 是 在 老生 第 谈 ， 用 于 处 理 变量 集合 的 所 有 工具 都 还 是 
人 














11.2.1 System.Tuple<.. .> 


.NET 4 中 的 System.Tuple<,, ,> 类 型 是 不 可 变 的 引用 类 型 ， 但 类 型 中 的 元 
素 类 型 可 以 是 可 变 类 型 。 我 们 可 以 把 它 看 作 一 种 浅 不 可 变 ， 就 像 
readonly 字 段 。 


这 个 特性 的 最 大 缺点 是 缺少 语言 集成 。 这 种 旧式 的 元 组 类 型 的 创建 过 程 
比较 复杂 ， 指 定 类 型 时 语法 也 比较 元 长 ， 没 有 提供 11.3 节 所 讲 的 类 型 转 
换 方 法 。 更 重要 的 是 ， 它 只 能 够 采用 Itemx 这 样 的 命名 方式 。 尽 管 C# 7 
元 组 的 元 素 名 称 只 在 编译 时 有 效 ， 但 依然 极 大 地 提升 了 自身 的 易 用 性 。 


此 外 ， 引 用 类 型 的 元 组 感觉 更 像 成 熟 的 对 象 而 非 值 的 简单 集合 体 ， 访 类 
型 的 优 缺 点 随 着 不 同 的 场景 而 有 所 不 同 。 通 常情 况 下 其 易 用 性 偏 低 ， 但 
是 对 于 大 型 Tuple<.. .> 对 象 之 间 的 引用 复制 ， 效 率 比 valueTuple<...> 

蜗 ， 因 为 后 者 需要 把 所 有 元 素 值 都 复制 一 裔 ， 就 线程 安全 来 讲 二 者 也 有 
区 别 : 引用 复制 是 原子 操作 ， 而 元 组 值 复 制 不 是 。 


11.5.2 ”匿名 类 型 

















匿名 类 型 是 作为 LINQ 的 一 部 分 被 引入 的 ， 根 据 我 的 经 验 ， 匿 名 类 型 也 
主要 用 于 LINQ 中 。 虽 然 从 理论 上 说 可 以 在 普通 方法 中 使 用 匿名 类 型 ， 
但 我 从 未 在 产品 代码 中 见 过 这 种 用 法 。 


C# 7 的 元 组 类 型 具备 匿名 类 型 的 大 部 分 优点 : 具名 元 素 、 自 然 等 价 以 及 
清晰 的 字符 串 表 示 。 匿 名 类 型 的 主要 问题 是 它们 是 匿名 的 ， 不 能 用 作 方 
法 返回 值 ， 也 不 能 在 保证 类 型 安全 的 前 提 下 用 于 属性 。〈 基 本 上 需要 使 
用 object 或 者 dynamic。 虽 然 类 型 信息 在 执行 期 存在 ， 但 编译 器 无 法 知 

晓 。) 而 C# 7 的 元 组 不 存在 该 问题 。 前 面 讲 过 ， 元 组 完全 可 以 用 于 返回 


类 型 。 
在 我 看 来 ， 匿 名 类 型 较 元 组 有 以 下 4 项 优势 。 


。 在 C# 7.0 中 ， 投 射 初 始 化 器 可 以 提供 一 个 标识 符 ， 其 中 包含 名 称 和 
值 ， 这 种 方式 比 元 组 简单 ， 例 如 对 比 new {fp.Name，p.Agey 和 (name: 
p.Name，age: p.Age)。C#7.1 解 决 了 这 一 问题 : 可 以 推断 元 组 元 素 
的 名 称 ， 因 而 其 表示 方式 更 简洁 : (p.Name，p.Age)。 

在 匿名 类 型 的 字符 串 表 示 中 包含 元 素 名 称 ， 这 有 利于 问题 诊断 。 
匿名 类 型 可 以 用 于 各 种 LINQ 提 供 器 (比如 数据 库 提供 器 〉， 而 元 
组 字面 量 不 能 用 于 表达 式 树 ， 这 是 元 组 的 一 处 重大 不 足 。 
匿名 类 型 在 某 些 情况 下 效率 更 高 ， 因 为 在 传递 过 程 中 使 用 的 是 引用 
值 。 不 过 多 数 情 况 下 ， 并 无 明显 优势 。 使 用 元 组 无 顷 创 建 对 象 ， 也 
就 减少 了 垃圾 回收 器 的 压力 ， 这 也 反 过 来 成 了 元 组 的 一 项 优势 。 


建议 在 LINQ to Objects 中 广泛 使 用 元 组 ， 在 C# 7.1 中 可 以 推断 元 素 名 称 
时 更 应 如 此 。 
































11.5.3 ”命名 类 型 





元 组 只 是 变量 的 简单 集合 ， 不 提供 封装 ， 不 预 设 变量 的 任何 含义 。 有 时 
这 就 是 理想 的 特性 ， 但 是 切 勿 滥用 。 考 虑 (double，double) 元 组 ， 它 可 
以 用 作 : 


二 维 华 卡 儿 坐标 (x, y); 
二 维 极 坐标 (半径 , 角度 ); 
一 维 线段 〈 两 个 端点 ) ; 
其 他 一 些 数字 。 





如 果 使 用 类 来 建 模 ， 以 上 每 个 用 例 的 操作 都 可 能 不 同 。 我 们 无 须 担 心 数 
据 填 充 错误 或 者 将 极 坐 标 和 备 卡 儿 坐 标 混 用 。 


如 果 只 需要 临时 的 值 组 合 ， 或 者 目前 处 于 原型 设计 阶段 ， 还 不 确定 需要 
什么 数据 类 型 ， 那 么 元 组 是 很 好 的 选择 ;但 如 果 要 在 代码 的 多 处 使 用 同 
一 个 组 合 数据 形态 ， 采 用 具名 的 类 型 会 更 好 。 


说 明 ”如果 Roslyn 代 码 分 析 器 可 以 自动 完成 以 上 操作 ， 使 用 元 组 元 
人 
J 工 上 其 。 


有 了 元 组 的 各 种 答 代 工具 之 后 ， 下 面 给 出 元 组 的 使 用 建议 。 


11.6 元 组 的 使 用 建议 


首先 需要 知道 ，C# 对 元 组 的 支持 是 在 C#7 中 新 增 的 。 本 章 关 于 元 组 的 使 
用 建议 都 基于 对 元 组 的 研究 ， 而 不 是 探讨 如 何 大 规模 使 用 ， 探 完 有 助 于 
思考 ， 但 对 指导 实际 使 用 帮助 不 大 。 例 如 此 前 我 对 于 何 时 使 用 新 特性 的 
ee 
尽 ，3 已 邦 。 


11.6.1 ” 非 公 共 API 以 及 易 变 的 代码 


在 元 组 特性 被 C# 社 区 广泛 采用 并 摸索 出 最 佳 实 践 之 前 ， 我 会 避免 在 公共 
API 中 使 用 元 组 ， 以 及 那些 可 能 被 其 他 程序 集 继承 的 受 保护 成 员 。 如 果 
我 们 可 以 掌控 《以 及 修改 ) 所 有 相关 代码 ， 可 以 尝试 一 下 ; 但 是 不 要 仅 
仅 因 为 贪图 方便 ， 而 让 公共 方法 返回 元 组 类 型 ， 最 后 还 是 得 重新 封 六 返 
回 类 型 。 虽 然 具 名 类 型 在 设计 和 实现 上 更 耗 时 ， 但 便于 调用 方 使 用 。 多 
数 情况 下 ， 元 组 对 实现 者 来 说 比较 简单 ， 而 对 调用 方 不 甚 友好 。 


我 目前 的 做 法 更 保守 : 只 把 元 组 用 作 茶 个 类 型 内 部 的 实现 细节 。 虽 然 我 
党 得 把 元 组 作为 茶 个 私有 方法 的 返回 值 没什么 问题 ， 但 仍 会 在 产品 代码 
中 避免 内 部 方法 返回 元 组 。 一 般 说 来 ， 决 策 所 影 啊 的 范围 越 小 ， 之 后 就 
越 容 易 调 整 想 法 ， 也 不 会 花费 太 多 精力 。 











11.6.2 ”局 部 变量 


元 组 的 设计 初衷 是 让 方法 可 以 一 次 返回 多 个 值 ， 从 而 避免 使 用 out 参 
数 ， 和 但 这 并 不 意味 着 元 组 的 使 用 价值 仅 
限于 此 。 


在 茶 个 方法 内 部 需要 对 变量 进行 自然 分 组 并 不 鲜 见 。 通 常 可 以 通过 看 这 
些 变 量 是 否 具有 相同 的 前 级 来 判断 。 例 如 代码 清单 11-11 中 的 方法 ， 该 
方法 可 能 用 于 在 东 个 游戏 中 展示 特定 日 期 的 最 高 分 玩家 。 虽 然 LINQ to 
Objects 有 Max 方 法 可 以 返回 最 大 值 ， 但 不 会 返回 与 该 最 大 值 相关 联 的 原 
始 序 列 元 素 。 


说 明 也 可 以 采用 蔡 代 方法 
orderByDescending(...),.FirstorDefault()， 但 这 就 等 于 为 查找 单 
一 值 而 将 整个 序列 排序 。MoreLinq 包 中 的 MaxBy 方 法 可 以 弥补 此 不 
尾 。 男 一 种 可 以 维护 两 个 变量 的 解决 方法 是 使 用 一 个 highestGame 
变量 ， 然 后 使 用 其 score 属 性 来 完成 比较 。 但 在 更 复杂 的 情况 下 ， 
这 种 解决 方案 也 许 不 可 行 。 


























代码 清单 11-11 展示 某 天 的 最 高 分 玩家 


public void DisplayHighScoreForDate(LocalDate date) 


var filteredGames = allGames .Where(game => game.Date == date) 
string highestPlayer = null; 
int highestScore = -1; 


foreach (var game in filteredGames ) 
if (game.Score > highestScore) 


highestPlayer = game.PlayerName; 
highestScore = game.Score 


Console.writeLine(highestPlayer == null 
? "No games played" 
: $"Highest Score Was {highestScore} by {highestPpPlayer}") 
} 


算 上 参数 共有 4 个 局 部 变量 : 


@ date 


e filteredGames 
e highestPlayer 
e highestScore 


最 后 两 个 变量 紧密 关联 : 二 者 同时 初始 化 ， 同 时 发 生变 化 。 此 时 可 以 考 
虑 使 用 一 个 元 组 变量 ， 代 码 如 下 所 示 。 


代码 清单 11-12 ”使 用 元 组 局 部 变量 进行 重 构 


public void DisplayHighScoreForDate(LocalDate date ) 








var filteredGames = allGames ,Where(game => game.Date == date) 
(string player, int score) highest = (null, -1); 
foreach (var game in filteredGames ) 


If (game.Score > highest.score) 


highest = (game.PlayerName, game.Score); 
} 
} 
Console.writeLine(highest.player == null 
? "No games played" 


: $"Highest Score Was {highest.score} by {highest.player} 
} 


代码 变动 部 分 已 加 粗 。 这 种 写法 好 于 之 前 的 吗 ? 从 逻辑 层面 讲 ， 当 我 们 
把 元 组 看 作 变 量 的 集合 ， 这 两 段 代 码 是 完全 相同 的 。 对 我 来 说 ， 第 2 种 
写法 稍 人 简洁 一 些 ， 因 为 它 从 顶层 设计 上 减少 了 方法 所 考虑 的 概念 数量 。 
不 过 书页 所 能 容纳 的 代码 示例 毕竟 规模 有 限 ， 实 际 给 读者 带 来 的 兰 异 感 
受 微乎其微 ， 但 对 于 难以 拆 分 的 大 型 方法 来 说 ， 使 用 元 组 局 部 变量 会 大 
不 相同 。 这 一 考量 对 于 字段 也 适用 。 








11.6.3 ”字段 


与 局 部 变量 类 似 ， 有 时 字段 也 有 聚集 效应 。 下 面 是 Noda Time 项 目 中 
PrecalculatedpateTimeZone 方 法 的 代码 : 


private readonly ZoneInterval[] periods,; 

private readonly IZoneIntervalMapwWithMinMax tailZone; 
private readonly Instant tailZoneStart; 

private readonly ZoneInterval firstTailZoneInterval; 


无 须 解释 这 些 字 段 舍 义 ， 后 面 3 个 字段 显然 都 和 tail zone 有 关 ， 因 此 可 以 
考虑 把 它们 简化 为 两 个 字段 ， 其 中 一 个 采用 元 组 : 


private readonly ZoneInterval[] periods,; 
private readonly 
(IZoneIntervalMapwithMinMax intervalMap, 
Instant start, 
ZoneInterval firstIinterval) tailZzone; 


之 后 的 代码 就 可 以 按照 tailzone .start、 tailzone.intervalMap 这 样 的 
方式 来 编写 下 请 注意 ， tailzone 被 声明 为 readonly， 那么 除了 构造 
器 ， 任 何 对 于 单个 元 素 的 赋值 都 是 非法 操作 ， 另 有 以 下 限制 和 须知 。 


。 在 构造 器 中 元 组 元 素 依 然 可 以 独立 赋值 ， 但 如 果 没 有 全 部 完成 赋 
值 ， 也 不 会 有 警告 信息 。 如 果 在 原始 代码 中 态 记 给 tailzonestart 
赋值 ， 就 会 收 到 一 条 警告 信息 ;如 果 瑟 了 给 tailzone.start 赋 值 ， 
便 不 会 有 同样 的 警告 信息 。 

。 元 组 字段 ， 要 么 全 部 是 只 读 的 ， 要 么 全 部 都 不 。 如 果 有 若干 相关 字 
段 ， 其 中 一 些 是 只 读 的 ， 而 男 外 一些 不 是 ， 那 么 只 能 抛弃 只 读 属 
性 ， 或 者 干脆 不 用 元 组 。 对 于 这 种 情况 ， 我 会 选择 不 使 用 元 组 。 

。 如 果 某 些 字段 属于 自动 实现 属性 的 字段 ， 那 么 只 能 自行 编写 完整 的 
属性 来 使 用 元 组 。 同 上 面 一 样 ， 我 还 是 会 选择 不 用 元 组 。 


最 后 还 有 关于 元 组 的 一 个 不 太 显 著 的 方面 一 一 和 动态 类 型 交互 的 问题 。 
11.6.4 ”元 组 和 动态 类 型 不 太 搭 调 


我 目 己 不 贡 使 用 dynamic， 因 为 我 认为 动态 类 型 和 元 组 无 法 实现 民 好 的 
交互 。 关 于 元 组 访问 ， 需 要 注意 两 个 问题 。 
1. 动态 绑 定 器 并 不 知道 元 组 名 称 
基本 上 元 素 名 称 属 于 编译 时 考虑 的 内 容 ， 而 动态 类 型 绑 定 发 生 在 执 
行 期 ， 可 以 想见 会 发 生 什 么 ， 示 例如 下 : 


dynamic tuple = (x: 10，y: 20); 

Console.writeLine(tuple.x); 

乍 一 看 可 能 会 觉得 这 段 代码 没什么 问题 ， 应 该 能 打印 出 10， 但 它 会 
抛 出 一 个 异常 : 


























Unhandled Exception: Microsoft.CSharp.RuntimeBinder .RUuNtimeBi 
'System.ValueTuple<int,int>' does not contain a definiti 


如 果 想 让 这 段 代 码 正 党 运 行 ， 需 要 大 量 额 外 工作 才能 让 动态 绑 定 器 


保留 元 素 名 称 信 息 ， 估 计 将 来 这 也 不 会 改进 。 现 在 只 能 将 其 改写 
成 tuple.Item1， 这 种 写法 对 于 前 7 个 元 素 都 是 适用 的 。 





( 现 阶 段 } 动态 绑 定 器 无 法 知道 7 以 上 的 元 素 序号 


11.5.4 节 讲 过 编译 器 可 以 处 理 超 过 7 个 元 素 的 元 组 。 编 译 器 使 用 度 为 
8 的 valueTuple<...>， 其 最 后 一 个 元 素 是 另 一 个 元 组 ， 该 元 组 通过 
Rest 字 段 访问 ， 而 不 是 通过 Ttem8。 编 译 器 除了 完成 类 型 本 身 的 转 
换 ， 还 需要 完成 元 素 序号 访问 的 转换 ， 比 如 在 二 代码 中 把 


tuple.Item9 转 换 成 tuple .Rest.Item2。 


在 编写 本 书 时 ， 动 态 绑 定 咽 依 然 无 法 识别 此 类 访问 ， 因 此 那些 采用 
编译 时 绑 定 可 以 正常 运行 的 代码 ， 换 成 动态 绑 定 之 后 就 会 抛 出 腊 
常 。 读 者 可 以 测试 和 答 试 以 下 代码 : 


var tuple = (1, 2, 3, 4, 5, 6, 7, 8, 9); 

















Console,WriteLine(tuple,Item9)，<------ 没有 问题 ， 指 网 tupJe ,Res 
dynamic d = tuple; 
Console.WwriteLine(d.Item9); <------ 在 执行 期 会 失败 











与 上 一 个 问题 不 同 ， 可 以 把 动态 绑 定 器 改造 得 更 智能 来 解决 这 个 问 
题 ， 但 是 执行 期 的 行为 取 诀 于 应 用 最 终 使 用 的 是 哪个 动态 绑 定 器 版 
本 。 通 常 需要 把 编译 器 版 本 与 程序 集 、framework 版 本 分 离开 来 。 
如 果 非 要 限制 动态 绑 定 器 的 版 本 ， 恐 介 是 要 把 这 潭 水 捞 浑 了 。 








11.7- 小结 


元 组 的 作用 : 不 提供 封装 的 元 素 的 简单 集合 。 

C# 7 中 的 元 组 具有 独特 的 语言 规则 和 CLR 表 示 。 

元 组 是 值 类 型 ， 其 字段 是 公共 且 可 变 的 。 

C# 元 组 支持 灵活 的 元 素 名 称 。 

CLR valueTuple<.. .> 结构 体 的 元 素 名 称 为 Item1l、Item2、...... 
C# 文 持 元 组 字面 量 和 元 组 类 型 之 间 的 转换 。 








第 12 章 ”分 解 与 借 式 匹配 
本 章 内 容 概览 


。 如 何 将 元 组 分 解 成 多 个 变量 ; 
。 如 何 分 解 非 元 组 类 型 ; 

。 如 何在 C# 7 中 应 用 模式 匹配 ; 

e。 如 何 使 用 C# 7 引入 的 3 类 模式 匹配 。 


第 11 章 介绍 了 元 组 组 合 数据 的 能 力 。 使 用 元 组 ， 无 须 创 建新 的 类 型 ， 只 
再 一 个 变量 即 可 表示 大 干 变量 的 集合 。 使 用 元 组 时 ， 需 要 从 中 逐个 取出 
变量 ， 例 如 打印 一 个 整数 序列 中 的 最 小 值 和 最 大 值 。 


上 述 用 法 当然 没有 问题 ， 而 且 很 多 情况 下 这 就 是 我 们 需要 的 功能 ， 但 有 
时 需要 把 一 个 值 的 组 合 拆 分 成 多 个 独立 变量 ， 该 操作 称 为 分 解 。 值 的 组 
合 可 能 是 元 组 ， 也 可 能 是 其 他 类 型 〈 比 如 KeyvaluePair ) 。C# 7 文 持 通 
过 简单 的 语法 来 实现 在 一 条 语句 中 声明 或 者 初始 化 多 个 变量 。 


分 解 没有 条 件 限 制 ， 就 像 一 系列 赋值 语 名 一样。 模式 匹配 也 与 之 类 似 ， 
但 是 模式 匹配 发 生 在 更 为 动态 的 上 下 文中 。 输 入 值 需要 与 模式 进行 匹 
配 ， 方 能 执行 后 续 代 码 。C# 7 为 一 些 上 下 文 引入 了 模式 匹配 及 多 种 模 
式 ， 在 将 来 的 版 本 中 可 能 引入 更 多 。 接 下 来 使 用 第 11 章 构建 的 元 组 来 研 
究 分 解 特性 。 

12.1 分 解 元 组 

C# 7 提供 两 种 分 解 方式 ， 一 种 是 分 解 元 组 ， 另 一 种 是 分 解 其 他 变量 。 这 
两 种 方式 语法 和 主要 特性 相同 。 与 其 空 讲理 论 ， 不 如 先 以 元 组 为 例 讲 
解 ， 之 后 针对 只 适用 于 元 组 的 操作 都 会 单独 提示 。12.2 节 会 讲 到 ， 其 他 
类 型 也 采用 了 同样 的 思路 。 代 码 清单 12-1 展 示 了 分 解 的 多 个 特性 ， 后 续 
会 详细 探讨 它们 。 

代码 清单 12-1 元 组 分 解 概览 


var tuple = (10, "text"); <------ 创建 一 个 元 组 类 型 (int，string) 

















var (a, b) = tuple; <------ 隐 式 地 将 元 组 分 解 到 两 个 新 变量 a 和 b 

















(int c, string d) = tuple; <------ 显 式 地 将 元 组 分 解 到 两 个 新 变量 c 和 d 
int e; (本 行 及 以 下 2 行 ) 分 解 到 现 有 变量 
string f; 


(e, ff) = tuple; 








Console .writeLine($"a; {a}; b; {b}"); (本 行 及 以 下 2 行 ) 证 明 分 解 成 功 了 
Console.writeLine($"c: {c}; d: {d}"); 
Console.writeLine($"e: {e}; f: {f}"); 


0 


a: 10; b: text 
c: 10; d: text 
e: 10; f: text 


这 段 代码 只 做 了 一 件 事 : 以 更 简单 的 代码 、 全 新 的 方式 声明 并 初始 化 了 
6 个 变量 一 一 a、b、c、d、e、f。 这 不 是 在 贬低 该 特性 的 作用 ， 但 其 中 
确实 没有 什么 细 市 值得 探讨 。 不 定 如 何 使 用 ， 这 一 操作 所 完成 的 束 只 是 
从 元 组 中 复制 值 ， 而 且 元 组 中 的 元 系 值 和 变量 之 间 并 无 关联 ， 双 方 的 任 
何 变 动 都 不 会 影响 对 方 。 


元 组 声明 语法 和 分 解 语法 


语言 规范 视 分 解 操 作 和 元 组 的 其 他 特性 密切 相关 。 即 便 分 解 对 象 不 
是 元 组 ， 也 是 通过 元 组 表达 式 描 述 分 解 操作 的 《〈12.2 节 会 讲 到 ) 。 
无 须 太 过 操心 这 一 点 ， 不 过 需要 注意 该 特性 可 能 引起 混淆 。 考 虑 以 
下 代码 : 

(int c, string d 
(int c, string d 
第 1 条 语句 通过 分 解 声 明了 c 和 d 两 个 变量 ， 而 第 2 条 语句 声明 了 元 组 
类 型 (int c，string d) 的 变量 x。 虽 然 这 一 相似 性 并 不 能 算是 设计 
失误 ， 但 就 像 表 达 式 主体 成 员 和 1lambda 表 达 式 那样 ， 需 要 花 一 些 时 
间 适 应 。 


首先 详细 分 析 以 上 代码 的 前 两 部 分 ， 它 们 实现 了 在 一 条 语句 中 声明 和 初 

















) = tuple; 
) x = tuple; 














始 化 变量 。 

12.1.1 分 解 成 新 变量 

在 分 解 特性 出 现 之 前 ， 一 直 可 以 在 一 条 语句 中 声明 多 个 变量 ， 只 不 过 这 
些 变量 的 类 型 必须 相同 。 为 了 保证 代码 的 可 读 性 ， 我 通常 一 条 语句 只 声 
明 一 个 变量 ; 但 是 知 能 在 一 条 语句 中 声明 和 初始 化 多 个 变量 ， 并 且 初 始 
化 值 都 来 自 同一 个 数据 源 ， 那 么 代码 可 以 变 得 十 分 简洁 。 如 果 数 据 源 是 
某 个 函数 调用 ， 还 可 以 利用 该 特性 来 避免 多 次 函数 调用 。 

为 了 展示 上 述 内 容 ， 代 码 中 的 变量 都 应 当 是 显 式 类 型 的 (和 形 参 列表 或 
元 组 类 型 相同 ) 。 下 面 创建 一 个 方法 (返回 元 组 值 ) 调用 ， 将 返回 值 分 
解 成 3 个 新 变量 。 

代码 清单 12-2 调用 一 个 方法 ， 然 后 将 返回 值 分 解 成 3 个 变量 


static (int x, int y, string text) MethodReturningTuple() => (1, 























static void Main() 


(int a, int b, string name) = MethodReturningTuple( ); 
Console.writeLine($"a: {a}; b: {b}; name: {name}"); 


再 来 看 看 不 使 用 分 解 所 实现 的 相同 代码 ， 以 此 凸显 分 解 特性 的 优势 。 编 
译 器 会 把 以 上 代码 转换 成 : 


static void Main() 


{ 

var tmp = MethodReturningTuple( ); 

int a = tmp.x; 

int b = tmp.y; 

string name = tmp.text; 

Console.writeLine($"a: {a}; b: {b}; name: {name}"); 
} 





后 面 这 段 代码 中 的 3 个 变量 声明 尚 可 接受 ， 但 是 额外 的 tmp 变 量 但 眼 。 见 
名 知 意 ，tmp 变 量 只 是 一 个 临时 变量 ， 它 唯一 的 作用 就 是 记录 方法 调用 
的 结果 ， 然 后 通过 它 来 初始 化 真正 需要 的 3 个 变量 a、b 和 name。 里 然 tmp 
变量 的 作用 域 很 小 ， 但 它 的 生命 周期 和 作用 域 与 其 他 变量 相同 ， 这 样 感 


觉 很 混乱 。 此 外 ， 在 分 解 时 ， 也 可 以 将 隐 式 类 型 和 显 式 类 型 进行 混用 ， 
见 图 12-1。 





图 12-1 在 分 解 操作 中 混用 显 式 类 型 和 隐 式 类 型 


需要 新 变量 类 型 和 元 组 元 素 类 型 不 同时 ， 这 一 行为 特别 有 用 ， 见 图 12- 
2。 


图 12-2 包含 隐 式 转换 的 分 解 操作 
如 果 需 要 对 所 有 变量 都 采用 隐 式 类 型 声明 ，C# 7 还 提供 了 一 种 简化 的 声 
明 方 式 : 把 var 置 于 变量 名 列表 之 前 即 可 。 


var (a, b, name) = MethodReturningTuple( ); 


这 种 方式 和 把 var 写 在 每 个 变量 前 面相 同 ， 也 和 显 式 指定 推 类 后 类型 的 
方式 相同 。 与 普通 的 隐 式 类 型 声明 一 样 ， 使 用 var 关 键 字 并 没有 让 该 变 
量 成 为 动态 类 型 ， 只 是 让 编译 右上 自行 做 类 型 推断 而 已 。 

里 然 在 小 括 写 内 可 以 把 隐 式 类 型 声明 和 显 式 类 型 声明 混用 ， 但 古 不 能 把 
var 放 在 括号 外 ， 同 时 又 在 括号 内 显 式 指定 茶 个 变量 的 类 型 。 


var (a, long b, name) = MethodReturningTuple(); <------ 非法 ， 将 两 入 


一 个 特殊 的 标识 符 : 丢弃 符 _ 





























C# 7 为 引入 局 部 变量 提供 了 3 个 特性 : 


。 分 解 〈 本 节 以 及 12.2 节 内 容 ) ; 

。 模式 〈12.3 节 和 12.7 节 内 容 ) ; 

。 out 变 量 〈14.2 节 内 容 ) 。 
在 以 上 3 种 情况 下 ， 使 用 单 下 划 线 〈(_)〉 为 变量 命名 都 会 给 该 变量 赋予 特 
殊 的 含义 :“ 我 不 关心 变量 结果 ， 也 根本 不 需要 这 个 变量 ， 直 接 丢 弃 
它 ”。 如 果 _ 用 作 变 量 名 ， 则 不 会 为 当前 作用 域 引 入 任何 新 变量 。 我 们 可 
以 使 用 任意 个 丢弃 符 来 表示 不 需要 的 变量 。 


在 分 解 操作 中 应 用 丢人 莽 符 的 示例 如 下 : 























var tuple = (1, 2, 3, 4); <------ 4 个 元 素 的 元 组 I 
var (x, y, _, _) = tuple; <------ 分 解 元 组 ， 只 保留 前 两 个 元 素 
Console.writeLine(_); <------ Error CS0103: 元 素 名 称 _ 不 存在 








假如 当前 作用 域 已 经 存在 一 个 名 为 _ 的 变量 (通过 正常 变量 声明 ) ， 我 
1 0 现 有 _ 变 量 的 值 不 会 受到 任何 影 
in| 。 

从 前 面 的 概览 示例 代码 可 知 ， 分 解 操作 中 也 可 以 不 用 声明 变量 。 分 解 操 
作 只 负责 一 系列 赋值 操作 。 


12.1.2 通过 分 解 操 作为 已 有 变量 或 者 属性 赋值 

前 面 介 绍 了 概览 例子 中 的 大 部 分 内 容 ， 下 面 看 看 这 段 代码 的 其 他 部 分 : 
var tuple = (10, "text"); 

int e; 


string f; 
(e, ff) = tuple; 


在 这 部 分 代码 中 ， 编 译 器 并 没有 把 分 解 操 作 看 作 一 系列 变量 声明 和 初始 

化 的 表达 式 ， 而 只 将 其 当 作 赋 值 操 作 序列 ， 同 样 具有 可 以 避免 临时 变量 

的 优势 。 代 码 清 单 12-3 沿 用 了 之 前 的 MethodReturningTuple() 方 法 。 
代码 清单 12-3 ”使 用 分 解 为 现 有 变量 赋值 


static (int x, int y, string text) MethodReturningTuple() => (1, 

















static void Main() 


= 





int a = 20; (本 行 及 以 下 3 行 ) 声明 、 初 始 化 并 使 用 3 个 变量 
int b 30， 

string name = "before"; 

Console.WriteLine($"a: {a}; b: {b}; name: {name}"); 








(a, b, name) = MethodReturningTuple(); <------ 使 用 分 解 为 3 个 变量 


Console.writeLine($"a: {a}; b: {b}; name: {name}"); <------ 于 


没什么 问题 ， 但 该 特性 的 功能 不 止 于 此 。 任 何 合法 的 单条 赋值 语句 都 可 
以 用 于 分 解 操 作 中 。 这 些 赋值 操作 包括 : 字段 、 属 性 或 者 索引 器 〈 数 组 
或 者 其 他 对 象 ) 。 





声明 还 是 赋值 ， 不 能 混用 


利用 分 解 操作 ， 可 以 声明 并 初始 化 变量 ， 或 者 执行 一 系列 赋值 ， 但 
是 不 能 将 二 者 混用 。 例 如 以 下 代码 非法 : 


int x; 
(x, int y) = (1, 2); 


但 赋值 操作 可 以 针对 不 同 目标 进行 混用 : 现 有 的 局 部 变量 、 字 段 以 
及 属性 等 。 








除了 一 般 的 赋值 操作 ， 还 可 以 给 丢弃 变量 赋值 ， 这 样 如 果 当 前 作用 域内 
没有 名 为 _ 的 变量 ， 则 会 丢 莽 该 值 ， 如 果 存 在 ， 则 会 正常 给 _ 变 量 赋值 。 


在 分 解 中 使 用 _: 赋值 还 是 丢弃 


乍 一 看 这 个 问题 比较 令 人 困惑 : 当 存 在 名 为 _ 的 变量 时 ， 分 解 操 作 
表现 为 赋值 ， 当 不 存在 时 则 表现 为 丢弃 。 可 以 通过 两 种 方式 避免 这 
种 困境 。 第 1 种 ， 但 看 分 解 操作 的 其 他 变量 是 舍 存 在 新 变量 的 引 
入 ， 如 果 存 在 ， 则 表示 丢弃 ; 如果 不 存在 ， 则 表示 赋值 。 


第 2 种 方式 简单 直接 : 不 要 把 _ 用 作 局 部 变量 的 名 称 。 

















实际 上 ， 几 乎 所 有 赋值 分 解 的 目标 无 外 乎 局 部 变量 、 字 段 或 tnis 的 属 


性 。 实 际 上 还 有 一 个 小 技巧 ， 能 让 C# 7 的 表达 式 主体 构造 器 更 强大 。 很 
多 构造 器 是 根据 其 参数 来 为 字段 或 者 属性 赋值 的 ， 如 果 先 把 这 些 参数 值 
收集 到 东 个 元 组 中 ， 然 后 把 元 组 作为 构造 器 参数 ， 束 可 以 在 构造 名 中 仅 
用 一 条 语句 就 完成 所 有 赋值 操作 了 。 


0 通过 元 组 字面 量 和 分 解 操 作 完 成 构造 器 赋值 的 简单 
未 僧 








public sealed class Point 


public double Xx { get,; } 
public double Y { get; } 


public Point(double x, double y) => (XxX, Y) = (x, y); 


这 段 代 码 简 洁 得 令 人 心 旷 神 恰 ， 构 造 右 参数 到 属性 之 间 的 映射 关系 也 清 
晰 明了， 而 且 编 译 器 还 能 识别 模式 ， 从 而 可 以 避免 构建 
ValueTuple<double，double>。 然 而 这 上 段 代 码 依然 需要 添加 对 
System.ValueTuple.dll 库 的 依赖 ， 我 只 好 暂 先 弃 之 不 用 了 。 如 果 将 来 工 
程 中 其 他 地 方 需要 使 用 元 组 或 者 引用 了 包含 system.valueTuple 库 的 其 他 
framework， 才 会 重新 考虑 这 种 写法 。 


这 是 C# 的 编程 范式 吗 

如 前 所 述 ， 这 一 技巧 优 缺 点 并 存 。 这 只 是 纯粹 的 构造 器 实现 细节 问 
题 ， 并 不 影响 类 主体 的 其 他 部 分 。 如 果 现 在 采用 这 种 写法 ， 之 后 想 
改 回 去 ， 改 动 也 会 很 小 。 目 前 还 很 难说 将 来 是 否 会 成 为 编程 范式 ， 
不 过 希望 如 此 。 如 果 元 组 字面 量 不 仅仅 作为 参数 值 ， 就 需要 更 加 小 
心 了 : 即使 添加 一 个 小 小 的 预 设 条 件 ， 赋 值 顺 友 就 会 失常。 


忠 执 行 顺 友 而 言 ， 赋 值 分 解 与 声明 分 解 相 比 ， 也 有 一 个 额外 的 缺陷 。 赋 
值 分 解 的 执行 分 为 3 个 阶段 : 


(1) 赋值 目标 进行 运算 ; 
(2) 赋值 操作 右 半 部 分 进行 运算 ; 
(3) 完成 赋值 。 








这 3 个 阶段 是 严格 按照 上 述 顺序 执行 的 。 在 每 个 阶段 内 ， 运 算 部 是 从 左 
到 右 依次 进行 的 。 这 个 顺序 一 般 不 会 造成 什么 问题 ， 但 依然 存在 极端 案 
例 。 


提示 ”如 果 读 者 在 理解 手头 代码 时 需要 忧虑 本 所 提 到 的 赋值 顺序 问 
题 ， 这 古 不 好 的 信号 。 如 果 读 者 能 够 理解 手头 代码 ， 建 议 立 刻 将 其 
重 构 。 分 解 操 作 在 表达 式 中 会 产生 副作用 ， 而 且 副 作用 还 会 被 放 
大 ， 因 为 每 个 阶段 都 存在 多 个 表达 式 计算 。 


对 于 这 个 话题 不 必 讨 论 太 多 ， 一 个 简单 的 例子 就 足以 说 明 将 来 可 能 会 明 
到 的 问题 。 下 面 所 举 的 例子 肯定 不 是 最 糟 料 的 状况 ， 现 实 往 往 更 光 怪 陆 
离 。 代 码 清单 12-5 把 一 个 (StringBuilder，int) 元 组 分 解 

到 StringBuilder 变 量 中 ， 然 后 Length 属 性 和 该 变量 相关 联 。 

代码 清单 12-5 在 计算 顺序 有 影响 的 情况 下 执行 分 解 操 作 


StringBuilder builder = new StringBuilder("12345"); 
StringBuilder original = builder; <------ 出 于 诊断 目的 保存 原始 buildel 


(builder，builder.Length) = (本 行 及 以 下 1 行 ) 执行 分 解 的 赋值 操作 
(new StringBuilder("67890"), 3); 

















Console .writeLine(original); (本 行 及 以 下 1 行 ) 打印 新 、 旧 builder 的 内 容 
Console.writeLine(builder); 


中 间 一 行 代码 是 本 例 的 关键 所 在 ， 其 中 关键 的 问题 又 在 于 : 哪 

个 stringBuilder 的 Length 属 性 被 赋值 了 ? 是 builder 的 原始 变量 ， 还 是 
在 分 解 操作 中 重新 被 赋值 的 builder 变 量 ? 如 前 所 述 ， 赋 值 目标 表达 式 
会 最 先进 行 计 算 ， 该 步骤 先 于 赋值 操作 。 


代码 清单 12-6 分 解 操 作 中 表达 式 计算 过 程 慢 放 


StringBuilder builder = new StringBuilder("12345"); 
StringBuilder original = builder; 








StringBuilder targetForLength = builder; <------ 计算 赋值 的 目标 





(StringBuilder，int) tuple = (本 行 及 以 下 1 行 ) 计算 元 组 字面 量 
(new StringBuilder("67890"), 3); 








builder = tuple.Item1; (本 行 及 以 下 1 行 ) 为 目标 赋值 
targetForLength.Length = tuple.Item2; 


Console.writeLine(original); 
Console.writeLine(builder); 


当 分 解 目 标 仅仅 是 一 个 局 部 变量 时 ， 不 存在 额外 的 运算 过 程 ， 可 以 直接 
赋值 ， 但 是 给 茶 个 变量 的 属性 赋值 会 引发 对 该 变量 值 的 计算 ， 该 计算 过 
程 属于 第 一 阶段 。 因 此 还 需要 一 人 targetForLength 变 量 。 


在 使 用 元 组 字面 量 构建 完成 目标 元 组 后 ， 再 将 不 同 的 元 素 赋 值 给 目标 变 
量 。 当 给 Length 属 性 赋值 时 ， 赋 值 目标 是 targetForLength 而 不 

是 builder。 被 赋值 的 是 原始 stringBuilder 的 Length 属 性 ， 其 值 

为 12345， 而 不 是 新 的 StringBuilder 的 67899， 因 此 代码 清单 12-5 和 代码 
清单 12-6 的 执行 结果 分 别 为 : 


123 
67890 


下 和 面 讨论 关于 构建 元 组 的 最 后 一 个 话题 ， 不 算 太 复杂 ， 然 后 探讨 非 元 组 
类 型 的 分 解 。 


12.1.3 ”元 组 字面 量 分 解 的 细节 


11.3.1 节 讲 过 ， 不 是 所 有 元 组 字面 量 都 具有 类 型 。 例 如 (null, x => x* 
2) 就 没有 类 型 ， 因 为 它 的 两 个 元 素 表 达 式 都 不 具有 类 型 ， 但 是 它 可 以 转 
换 成 (string，Func<int，int>)， 因 为 每 个 表达 式 都 可 以 转换 成 对 应 的 
后 者 类 型 。 


好 在 元 组 分 解 操 作 也 有 完全 相同 的 “对 应 元 素 赋 值 兼容 机制， 声明 分 解 
和 赋值 分 解 都 适用 ， 示 例如 下 : 


(string text，Func<int，int> func) = (本 行 及 以 下 1 行 ) 分 解 并 声明 text 和 
(Null, x => x * 2); 
(text, func) = ("text", x => x * 3); <------ 分 解 并 为 text 和 func 赋 值 


需要 进行 隐 式 类 型 转换 的 分 解 操 作 也 可 以 按照 同样 的 方式 执行 。 还 是 举 
Oe 
法 : 






































(byte x, byte y) = (5, 10); 


与 很 多 优 民 的 语言 特性 类 似 ， 该 特 ， 年 也 属于 行为 和 预期 一 致 ， 但 是 语言 
本 身 需 要 认真 设计 ， 并 且 对 外 公开 所 文 持 的 功能 。 掌 握 了 元 组 分 解 操 
作 ， 非 元 组 的 分 解 操 作 就 容易 理解 了 。 


12.2” 非 元 组 类 型 的 分 解 操 作 


非 元 组 类 型 的 分 解 ， 使 用 的 是 一 种 类 似 于 async/await 和 foreach、 基 于 
模式 1 的 方式 。 正 如 任何 具有 合适 的 GetAwaiter 方 法 或 者 扩展 方法 的 类 
型 都 可 以 使 用 await 一 样 ， 任 何 具 有 合适 的 Deconstruct 方 法 或 扩展 方法 
的 类 型 ， 都 可 以 使 用 与 元 组 相同 的 语法 完成 分 解 。 首 先 看 看 普通 实例 方 
法 的 分 解 操作 。 


1 该 模式 和 12.3 节 中 的 模式 完全 不 同 ， 很 遗憾 出 现 术语 冲突 。 





12.2.1 ”实例 分 解 方法 

简单 起 见 ， 沿 用 前 文 的 Point 类 作为 示例 ， 并 添加 如 下 Deconstruct 方 法 
实现 : 

public void Deconstruct(out double x, out double y) 


x 
y 


X; 
Y; 

} 

代码 清单 12-7 可 以 把 任何 Point 对 象 分 解 成 两 个 浮 点 型 变量 。 


代码 清单 12-7 ”把 point 对象 分 解 成 两 个 变量 











var point = new Point(1.5, 20); <------ 创建 一 个 Point 实 例 
var (x, y) = point; <------ 将 point 分 解 成 两 个 double 类 型 的 变量 
Console.WriteLine($'"x = {x}"); (本 行 及 以 下 1 行 ) 打印 变量 值 
Console.WriteLine($"y = {y}"); 


Deconstruct 方 法 负责 把 分 解 之 后 的 结果 填充 到 out 参 数 ， 在 本 例 中 是 把 
某 个 Point 对 象 分 解 到 两 个 double 类 型 值 。 从 名 称 不 难看 
出 ，Deconstruct 方 法 是 一 个 类 似 于 构造 方法 的 逆 方 法 。 


且慢 ! 之 前 用 过 一 个 小 技巧 : 可 以 通过 元 组 在 构造 器 中 仅 用 一 条 语句 完 








成 参数 到 属性 的 赋值 ， 这 里 能 人 否 采 用 同样 的 策略 呢 ? 当然 可 以 ， 我 个 人 
还 很 倾向 于 这 种 方式 。 下 面 给 出 Point 类 型 的 构造 器 和 分 解 器 的 实现 代 
码 ， 二 者 的 相似 性 也 不 难看 出 : 


public Point(double x, double y) => (XxX, Y) = (x, y); 
public void Deconstruct(out double x, out double y) => (x, y) = ( 


习惯 了 这 种 写法 之 后 ， 就 会 发 现 构 造 右 与 分 解 右 的 同 构 性 所 带 来 的 和 谐 
之 美 是 难以 言 表 的 。 


分 解 操作 所 用 的 peconstruct 实 例 方法 需要 满足 以 下 几 条 简单 规则 。 


。 分 解 方法 对 于 执行 分 解 操作 的 代码 必须 是 可 访问 的 。《〈 如 果 所 有 代 
人 码 都 位 于 同一 个 程序 集中 ， 那 么 可 以 使 用 internal 来 修 
饰 Deconstruct 方 法 。) 

。 该 方法 的 返回 值 必须 是 void。 

。 参数 个 数 不 少 于 2 《因为 不 可 能 分 解 一 个 值 ) 。 

。 该 方法 必须 是 非 泛 型 方法 。 


读者 可 能 会 有 疑问 : 为 什么 peconstruct 方 法 使 用 out 参 数 ， 而 不 是 一 个 
返回 元 组 的 无 参 方法 呢 ? 答案 是 : 这 种 设计 可 以 适应 多 组 值 的 分 解 。 当 
存在 多 组 值 需要 分 解 时 ， 就 需要 多 个 重 载 方法 来 实现 ， 但 重 载 方法 无 法 
仪 通过 返回 值 来 区 分 。 这 么 说 可 能 有 些 抽象 ， 下 面 举例 说 明 。 还 是 以 

DateTime 为 例 ， 如 果 要 给 DateTime 这 加 Deconstruct 方 法 ， 同 时 无 法 直接 
0 
2 


12.2.2 ”扩展 分 解 方法 与 重 载 
引文 部 分 简单 介绍 过 ， 编 译 器 会 查找 任何 符合 相关 模式 的 peconstruct 
方法 ， 其 中 也 包括 扩展 方法 。 读 者 应 该 能 够 猜想 出 扩展 分 解 方法 的 写 
法 ， 示 例如 下 。 

代码 清单 12-8 ”使 用 扩展 方法 分 解 DateTime 


static void Deconstruct( (本 行 及 以 下 4 行 ) 分 解 DateTime 的 扩展 方法 
this DateTime dateTime, 
out int year, out int month, out int day) => 
(year, month, day) = 














(dateTime.Year, dateTime.Month, dateTime.Day); 


static void Main() 











{ 
DateTime now = DateTime.UtcNow; 
var (year, month, day) = now; <------ 将 当前 日 期 分 解 成 年 /月 /日 
Console.writeLinel( 
$"{year:0000}-{month:00}-{day:00}"); <------ 使 用 3 个 变量 打 日 
} 





在 本 例 中 ， 定 义 的 扩展 方法 刚好 和 调用 代码 在 同一 个 静态 类 中 ， 它 只 是 
一 个 私有 扩展 方法 。 通 常 大 部 分 扩展 方法 应 该 是 公共 的 或 者 internal 的 。 


如 果 需 要 把 DateTime 分 解 成 比 日 期 更 详细 的 结果 ， 该 怎么 做 呢 ? 此 时 就 
需要 重 载 方法 了 。 可 以 实现 两 个 具 [有 不 同 参数 列表 的 方法 ， 然后 由 编译 
铝 根 据 调 用 参数 的 个 数 来 决定 调用 哪个 方法 。 下 面 添加 驴 一 个 扩展 方 
A 间 ， 然 后 用 这 两 个 方法 完成 不 同 的 分 
笃 操 作 。 


代码 清单 12-9 使 用 peconstruct 重 载 


static void Deconstruct( (本 行 及 以 下 4 行 ) 将 日 期 分 解 成 年 /月 /日 
this DateTime dateTime, 
out int year, out int month, out int day) => 
(year, month, day) = 
(dateTime.Year, dateTime.Month, dateTime.Day); 




















static void Deconstruct( (本 行 及 以 下 6 行 ) 将 日 期 分 解 成 年 /月 /日 /时 /分 / 秒 
this DateTime dateTime, 
out int year, out int month, out int day, 
out int hour, out int minute, out int second) => 
(year, month, day, hour, minute, second) = 
(dateTime.Year, dateTime.Month, dateTime.Day, 
dateTime.Hour, dateTime.Minute, dateTime.Second); 


static void Main() 


{ 
DateTime birthday = new DateTime(1976, 6, 19); 


DateTime now = DateTime.UtcNow; 


var (year, month, day, hour, minute, second) = now; <------ 但 
(year, month, day) = birthday; <------ 使 用 3 个 参数 的 分 解 器 





对 于 那些 已 经 具备 Deconstruct 实 例 方法 的 类 型 ， 也 可 以 为 其 添 
加 Deconstruct 扩 展 方法 。 当 分 解 该 类 型 时 ， 如 果实 例 方 法 不 适用 ， 就 
会 调用 合适 的 扩展 方法 ， 这 和 一 般 的 方法 调用 流程 相同 。 


Deconstruct 扩 展 方法 的 使 用 规则 ， 自然 和 实例 方法 保持 一 致 : 


。 需要 对 于 调用 代码 可 见 ; 
。 除了 第 一 个 参数 (扩展 方法 的 目标 类 型 )， 其 他 参数 必须 是 out 参 
兴 


; 

。 out 参 数 的 个 数 不 少 于 2; 

。 方法 可 以 是 泛 型 ， 但 只 有 扩展 方法 的 调用 目标 《第 一 个 参数 ) 才能 
参与 类 型 推断 。 


上 述 规则 中 ， 关 于 何 时 方法 可 以 是 泛 型 ， 何 时 不 能 是 泛 型 ， 值 得 深入 探 
究 ， 因 为 背后 的 原理 有 助 于 我 们 理解 为 何 需要 根据 参数 个 数 来 重 

载 Deconstruct 方 法 。 关 键 在 于 编译 器 是 如 何 看 符 和 处 理 pDeconstruct 方 
法 的 。 


12.2.3 ”编译 器 对 于 Deconstruct 调 用 的 处 理 

在 代码 能 够 正常 执行 的 情况 下 ， 一 般 不 需要 特别 关心 编译 器 是 如 何 决定 
应 该 调用 哪个 beconstruct 方 法 的 ; 但 是 如 果 代 码 未 能 正确 执行 ， 就 需 
要 从 编译 器 的 角度 认真 审视 了 。 

Deconstruct 方 法 的 执行 时 序 关 系 和 前 面 讨论 的 元 组 分 解 时 序 关 系 一 

致 ， 因 此 接 下 来 重点 关注 方法 调用 本 身 。 请 看 下 面 这 个 “具体 ”示例 ， 当 
编译 器 面 对 这 样 一 个 分 解 操 作 时 ， 需 要 执行 哪些 步骤 呢 ? 


(int x, string y) = target 


之 所 以 要 给 “具体 ”一 词 加 引号 ， 是 因为 target 的 类 型 尚 个 明确 。 这 里 故 
意 隐 藏 了 target 的 类 型 ， 我 们 只 需要 知道 它 不 是 一 个 元 组 类 型 即 可 。 编 
译 器 会 把 以 上 代码 扩展 为 : 

target.Deconstruct(out var tmpX, out Var tmpY); 


int x = tmpxX; 
string y = tmpY; 


之 后 编译 器 按 照 第 规 方 法 的 调用 规则 来 售 找 合适 的 方法 。out var 这 样 




















的 用 法 之 前 未 讲 ， 不 过 不 用 担心 ，14.2 节 会 详细 探讨 。 现 在 只 需要 知道 
它 是 一 个 隐 式 声明 的 类 型 ， 根 据 out 参 数 来 推 关 类 型 。 


这 里 的 重点 是 : 源码 中 声明 的 两 个 变量 类 型 其 实 并 没有 用 于 
Deconstruct 方 法 调用 ， 即 这 两 个 变量 并 没有 参与 类 型 推 新 。 这 一 事实 
解释 了 如 下 3 个 问题 。 


。 Deconstruct 实 例 方法 不 能 是 泛 型 方法 ， 因 为 泛 型 方法 无 法 为 类 型 
推断 提供 有 效 信息 。 

e。 Deconstruct 扩 展 方法 可 以 是 泛 型 方法 ， 因为 编译 器 可 能 根据 target 
0 
SS 源 。 

。 在 Deconstruct 方 法 进行 重 载 时 ，out 参 数 的 个 数 是 决定 性 因素 ， 而 
非 参数 类 型 。 如 果 再 添加 一 个 和 已 有 方法 out 参 数 个 数 相 同 的 重 载 
方法 ， 编 译 器 会 因为 无 法 决定 应 该 调用 哪个 方法 而 终止 编译 。 


这 部 分 内 容 就 到 此 为 止 ， 不 涉足 需求 范围 之 外 的 内 容 。 如 果 读 者 过 到 难 
以 理解 的 问题 ， 可 以 答 试 将 代码 进行 转换 ， 可 能 会 有 拨 云 见 日 的 效果 。 


以 上 便 是 分 解 操 作 需 要 掌握 的 全 部 和 内容。 后 面 主 要 讨论 模式 匹配 的 话 
题 。 昌 然 从 理论 上 讲 模式 匹配 和 分 解 特性 不 存在 任何 关联 ， 但 是 二 者 在 
以 新 方式 处 理 现 有 数据 方面 是 相近 的 。 


12.3 ”模式 匹配 简介 


和 其 他 很 多 特性 类 似 ， 模 式 匹配 这 个 概念 虽然 对 于 C# 语 言 而 言 是 新 特 
性 ， 但 是 在 其 他 语言 中 并 不 新 鲜 ， 尤 其 函数 式 语言 经 常 使 用 模式 。C#7 
引入 的 各 种 模式 ， 既 兼容 已 有 语法 ， 又 能 满足 很 多 同类 的 使 用 场景 。 


模式 的 基本 思想 是 : 检查 茶 个 值 的 特定 方面 ， 然 后 根据 检查 结果 执行 其 
他 操作 。 听 起 来 很 像 1f 语 句 ， 但 模式 可 以 为 条 件 提 供 更 多 上 下 文 信息 ， 

或 者 为 后 续 操作 提供 上 下 文 信息 。 诚 然 ， 该 特性 并 不 能 实现 全 新 的 功 

能 ， 但 能 让 我 们 在 编码 中 更 清晰 地 表达 意图 。 


话 不 多 说 ， 例子 先行 。 温 似 提示: 接 下 来 的 示例 可 能 看 起 来 比较 奇怪 ， 
我 们 只 是 通过 它 获 得 一 些 初步 的 认识 。 假 设 有 一 个 抽象 类 shape， 在 该 
类 中 定义 了 一 个 抽象 属性 Area， 然 后 有 3 个 类 Rectangle、circle 和 























Triangle 继 承 自 该 抽象 类 。 对 于 这 个 例子 ， 和 暂时 不 需要 定义 每 个 形状 的 

只 ， 而 需要 定义 每 个 形状 的 周 长 。 我 们 可 能 无 法 通过 修改 shape 来 添 
加 Perimeter 属 性 (甚至 不 能 掌控 这 部 分 源码 的 任何 内 容 ) ， 但 是 我 们 
知道 每 个 类 型 周 长 的 计算 方式 。 在 C#7 之 前 ，Perimeter 方 法 如 下 所 
坷 Sa 


代码 清单 12-10 不 采用 模式 特性 计算 周 长 


static double Perimeter(Shape shape) 





if (shape == null) 
throw new ArgumentNullException(nameof(shape)); 
Rectangle rect = shape as Rectangle; 
if (rect != null) 
return 2 * (rect.Height + rect.width); 
Circle circle = shape as Circle; 
if (circle != null) 
return 2 * PI * circle.Radius,; 
Triangle triangle = shape as Triangle; 
if (triangle != null) 
return triangle.SideA + triangle.SideB + triangle.Sidec; 
throw new ArgumentException( 
$"Shape type {shape.GetType()} perimeter unknown", nameof 


说 明 上 面 这 段 代 码 缺 少 大 括号 ， 某 些 读者 可 能 会 感到 不 适 。 我 通 
常会 为 所 有 循环 、if 语 句 都 添加 大 括号 ， 但 是 这 段 代 码 以 及 后 续 代 
码 主 要 用 于 展示 模式 特性 ， 补 齐 大 括号 势必 哈 宾 夺 主 。 
这 段 代 码 不 美观 ， 繁 复 且 元 余 。 其 中 关于 “检查 当前 形状 是 否 为 特定 形 
状 ， 然 后 调用 该 类 型 的 属性 ”这 一 模式 出 现 了 3 次 之 多 。 重 要 的 是 ， 虽 然 
方法 中 有 3 条 if 语句 ， 但 是 每 个 计 最 后 都 会 执行 return 语 句 ， 因 此 每 次 
只 能 执行 其 中 一 个 if 分 支 。 代 码 清单 12-11 是 采用 C# 7 模式 匹配 加 switch 
语句 实现 同样 的 功能 。 


代码 清单 12-11 使 用 模式 特性 计算 周 长 


static double Perimeter(Shape shape) 











switch (shape) 


{ 

















case null: (本 行 及 以 下 1 行 ) 处 理 nu]11 值 
throw new ArgumentNullException(nameof (shape)); 

















case Rectangle rect: (本 行 及 以 下 5 行 ) 处 理 每 个 已 知 类 型 
return 2 * (rect.Height + rect.width); 
case Circle circle: 
return 2 * PI * circle.Radius,; 
case Triangle tri: 
return tri.SideA + tri.SideB + tri.Sidec; 
default: (本 行 及 以 下 1 行 ) 对 于 未 知 类 型 抛 出 异常 
throw new ArgumentException(...); 











3 
} 


在 C# 7 之 前 的 版 本 中 ，switch 语 句 中 的 case 标 签 只 能 是 常量 值 ， 而 这 里 
的 switch 语 句 似乎 打破 了 这 一 限制 。 在 这 段 代 码 中 ， 我 们 时 而 关心 值 是 
个 匹配 (null case 的 部 分 ) ， 时 而 关心 值 的 类 型 是 否 匹 配 
(rectangle、circle 和 triangle case 的 部 分 ) 。 在 进行 类 型 匹配 时 ， 
还 会 引入 一 个 新 变量 ， 之 后 可 以 通过 该 变量 来 计算 周 长 。 


C# 中 的 模式 特性 有 两 个 话题 需要 探讨 : 


。 模式 特性 的 语法 ; 
。 模式 特性 应 用 的 上 下 文 。 


刚 开始 可 能 会 感觉 这 两 部 分 都 是 全 新 的 内 容 ， 似 乎 不 应 将 二 者 区 分 看 
待 ， 但 C# 7.0 引 入 的 几 个 模式 仅仅 是 个 开端 ，C# 设 计 团队 精心 设计 了 语 
法 ， 以 便 日 后 可 以 容纳 更 多 新 模式 。 一 旦 了 解 了 C# 语 言 在 哪些 位 置 为 未 
来 的 新 模式 预 留 了 空间 ， 将 来 学 习 新 模式 就 容易 多 了 。 这 是 一 个 类 似 
于 “ 鸡 生 蛋 蛋 生 鸡 ” 的 问题 ， 很 难 在 讨论 一 个 特性 的 同时 不 涉及 另 一 个 特 
性 的 内 容 ， 但 首先 还 是 介绍 C# 7.0 中 所 有 可 用 的 新 模式 。 


12.4 C# 7.0 可 用 的 模式 
C# 7.0 引 入 了 3 种 模式 ， 常 量 模式 、 类 型 模式 和 var 模 式 。 接 下 来 通过 is 
运算 符 分 别 展示 3 种 模式 。is 运 算 符 是 模式 特性 使 用 上 下 文 的 一 种 。 


每 种 模式 都 尝试 匹配 一 个 输入 。 输 入 可 以 是 任何 非 指 针 类 型 的 表达 式 。 
简单 起 见 ， 后 文 在 描述 模式 时 ， 都 会 使 用 input 来 指 代 模式 的 输 
入 。input 看 似 变量 ， 但 并 不 一 定 是 变量 。 




















12.4.1 常量 模式 





顾名思义 ， 和 常量 模式 由 编译 时 第 量 表 达 式 组 成 ， 之 后 使 用 input 来 进行 
等 价 检查 。 如 果 input 和 常量 表达 式 都 是 整 型 表达 式 ， 那 么 会 使 用 == 来 
进行 比较 ; 如 果 是 其 他 类 型 ， 则 使 用 静态 方法 object .Equals 进 行 比 
较 。 需 要 重点 关注 这 里 的 静态 方法 ， 因 为 它 保 证 了 null 值 检查 时 的 安 
全 。 代 码 清单 12-12 的 实际 意义 不 大 ， 但 能 展示 很 多 有 趣 之 处 。 


代码 清单 12-12 简单 常量 匹配 


static void Match(object input) 


L 











if (input is "hello") 
Console.writeLine("Input is string hello"); 
else if (input is 5L) 
Console.writeLine("Input is long 5"); 
else if (input is 10) 
Console.writeLine("Input is int 10"); 
else 
Console.writeLine("Input didn't match hello, long 5 or in 
} 
static void Main() 
{ 
Match("hello"); 
Match(5L); 
Match(7); 
Match(10); 
Match(10L); 
} 


的 结果 如 下 所 示 ， 其 中 大 部 分 很 好 理解 ， 只 有 倒数 第 2 行 可 能 比较 
费解 : 


Input is string hello 

Input is long 5 

Input didn't match hello, long 5 or int 10 
Input is int 10 

Input didn't match hello, long 5 or int 10 


如 果 整 型 比较 是 通过 == 运 算 符 完成 的 ， 那 么 为 何 最 后 一 次 调 

用 Match(16L) 不 匹配 呢 ? 这 是 因为 编译 时 的 input 并 不 是 int 类 型 ， 而 
是 object 类 型 ， 所 以 编译 器 生成 的 等 价 调用 是 object.Equals(x，19)。 
当 x 是 装 箱 后 的 Int64 而 不 是 装 箱 后 的 Int32 时 ， 该 方法 返回 false。 这 正 
是 最 后 一 次 调用 Match 背 后 所 发 生 的 事情 。 使 用 == 进 行 比较 的 例子 如 
下 : 











long x = 10L; 
if (x is 10) 


Console.writeLine("x is 10"); 


. 


is 表达 式 的 这 种 用 法 很 少 会 用 到 。is 表 达 式 多 用 于 switch 语 句 中 。 可 能 
会 有 一 些 整 型 常量 值 ( 类 似 于 预 匹 配 的 switch 语 句 ) 以 及 一 些 其 他 模 
式 。 相 较 而 言 ， 类 型 模式 显然 更 有 用 。 


12.4.2 ”类 型 模式 


类 型 模式 由 一 个 类 型 和 一 个 标识 符 组 成 ， 有 点 像 变量 声明 。 与 is 运算 符 
类 似 ， 如 果 input 是 该 类 型 的 值 ， 那 么 匹配 成 功 。 使 用 类 型 模式 的 一 个 
好 处 是 ， 匹 配 到 后 会 引入 一 个 新 的 模式 变量 ， 该 变量 的 类 型 为 匹配 成 功 
的 类 型 ， 变量 值 会 被 初始 化 为 input 的 值 。 如 果 input 的 值 为 nu11， 那么 
它 将 匹配 不 到 任何 类 型 。 根 据 12.1.1 节 所 述 ， 下 划 线 标识 符 _ 可 用 于 变量 
名 称 ， 此 时 它 表 示 抛 弃 变 量 ， 不 会 引入 新 变量 。 代 码 清 单 12-13 是 代码 
清单 12-10 的 变形 版 ， 但 没有 采用 switch 语 句 。 


代码 清单 12-13 ”使 用 类 型 匹配 代 蔡 asy/if 


static double Perimeter(Shape shape) 

















if (shape == null) 
throw new ArgumentNullException(nameof(shape)); 
if (shape is Rectangle rect) 
return 2 * (rect.Height + rect.width); 
if (shape is Circle circle) 
return 2 * PI * circle.Radius,; 
if (shape is Triangle triangle) 
return triangle.SideA + triangle.SideB + triangle.Sidec; 
throw new ArgumentException( 
$"Shape type {shape.GetType()} perimeter unknown", nameof 
} 


对 于 本 例 ， 我 当然 倾向 于 使 用 switch 语 句 ， 但 是 如 果 只 需要 替换 一 

个 as/if， 这 么 做 就 有 点 大 材 小 用 了 。 类 型 模式 主要 用 于 替代 as/if 组 合 
或 者 在 if 语句 中 使 用 is 然后 转换 类 型 的 情况 。 如 果 需 要 检查 的 对 象 是 非 
可 空 值 类 型 ， 那 么 应 采用 后 一 种 方式 。 


在 类 型 模式 中 ， 所 指定 的 类 型 不 能 是 可 空 值 类 型 ， 但 可 以 是 类 型 形 参 ， 











而 且 这 个 类 型 形 参 在 执行 期 可 以 是 可 空 值 类 型 。 在 这 种 情况 下 ， 只 有 值 
非 空 时 才能 成 功 匹 配 。 在 代码 清单 12-14 中 ， 类 型 模式 中 使 用 了 一 个 类 
型 形 参 ， 并 使 用 int? 作 为 方法 调用 的 类 型 实 参 ， 不 过 value is int? t 这 
样 的 表达 式 无 法 通过 编译 。 


代码 清单 12-14 ”在 类 型 模式 中 可 空 值 类 型 的 行为 


static void Main() 


{ 








CcheckType<int?>(null); 

CheckType<int?>(5); 

CheckType<int?>("text"); 

checkType<string>(null); 

CheckType<string>(5); 

CcheckType<string>("text"); 
} 


static void CheckType<T>(object value) 
if (value is T t) 


Console.writeLine($"Yes! {t} is a {typeof(T)}"); 
} 


else 


Console.writeLine($"No! {value ?7? "null"} is not a {typeo 
} 
输出 结果 如 下 : 


No! null is not a System.Nullable 1[System.Int32] 
Yes! 5 is a System.Nullable 1[System.Int32] 

No! text is not a System.Nullable 1[System.Int32] 
No! null is not a System.String 

No! 5 is not a System.String 

Yes! text is a System.String 


下 面 讨论 C# 7.0 中 关于 类 型 模式 的 问题 (C# 7.1 解 决 了 该 问题 ) 。 如 果 
你 的 项 目 使 用 的 是 C# 7.1 或 者 更 高 版 本 ， 可 能 根本 不 会 发 现 这 个 问题 。 
之 所 以 解释 这 个 问题 ， 旨 在 避免 某 些 读者 从 C# 7.1 的 工程 复制 代码 到 C# 
7.0 时 遇 到 麻烦 。 


在 C# 7.0 中 ， 如 下 所 示 的 类 型 模式 : 





x is SomeType y 


再 要 确保 x 的 编译 时 类 型 可 以 转换 为 SomeType。 这 个 要 求 听 起 来 完全 合 
理 ， 不 过 一 旦 涉及 泛 型 束 会 遇 到 麻烦 。 代 码 清 单 12-15 包 含 了 一 个 泛 型 
方法 ， 该 方法 通过 类 型 模式 来 展示 形状 的 一 些 细节 信息 。 

代码 清单 12-15 ”使 用 类 型 模式 的 泛 型 方法 


static void DisplayShapes<T>(List<T> shapes) where T : Shape 





foreach (T shape in shapes) <------ 变量 类 型 是 一 个 类 型 形 参 T 





switch (shape) <------ 对 该 变量 使 用 switch 


{ 

case Circle c: <------ 转换 为 具体 的 形状 类 型 
Console.writeLine($"Circle radius {c.Radius}"); 
break; 

case Rectangle r: 
Console.writeLine($"Rectangle {r.width} x {r.Heig 
break; 

case Triangle tt: 
Console.writeLinel( 

$"Triangle Sides {t.SideA}, {t.SideB}, {t.Sid 

break; 





} 

这 段 代码 在 C# 7.0 中 是 不 能 通过 编译 的 ， 因 为 下 面 这 上 段 代码 也 无 法 通过 
编译 。 

if (shape is Circle) 


Circle c = (Circle) shape; 
} 
其 中 is 运 算 符 的 使 用 是 合法 的 ， 但 是 类 型 转换 是 非法 的 。 类 型 形 参 无 法 
直接 转换 类 型 的 问题 ， 是 困扰 了 C# 很 久 的 一 笑 眼 中 钉 。 一 般 会 采 
用 object 作 为 中 间 过 渡 来 解决 : 


if (shape is Circle) 





Circle c = (Circle) (object) shape; 


这 种 解决 方式 在 处 理 一 般 类 型 转换 时 已 经 够 笨拙 了 ， 搭 配 优雅 的 模式 特 
性 之 后 ， 就 更 显得 丑 不 堪 言 了 。 


在 代码 清单 12-15 中 ， 一 种 解决 办 法 是 接收 一 个 IEnumerable<Shape> 参 数 
(利用 List<circle> 到 IEnumerable<Shape> 之 间 存 在 的 泛 型 协 变 ) ， 男 
一 种 解决 办 法 是 不 使 用 泛 型 T， 直 接 用 shape 代 符 。 如 采 换 成 其 他 情况 ， 
恐怕 就 没 这 么 简单 了 。 在 C# 7.1 中 ， 类 型 模式 下 任何 类 型 都 可 以 使 用 as 
运算 符 ， 这 样 代码 清单 12-15 束 可 以 通过 编译 了 。 


在 C# 7.0 引 入 的 这 3 种 模式 中 ， 我 认为 类 型 模式 更 党 用。 下面 介绍 最 后 一 
种 模式 ， 该 模式 听 起 来 根本 就 不 像 模 式 。 











12.4.3 ”var 模式 


var 模 式 看 起 来 与 类 型 模式 类 似 ， 区 别 是 把 var 作 为 类 型 ， 因 此 其 基本 语 
法 就 是 var 后 面 跟 一 个 标识 符 : 


someExpression is Var x 


与 类 型 模式 类 似 ，var 模 式 也 会 引入 一 个 新 变量 ， 但 与 类 型 模式 不 同 的 
是 ， 它 并 不 检查 任何 内 容 。var 模 式 总 能 匹配 成 功 ， 然 后 得 到 一 个 新 变 
量 ， 该 变量 和 input 的 类 型 相同 ， 值 也 和 input 相 同 ， 而 且 即 便 input 
是 nul1 引 用 ，var 模 式 仍 能 成 功 匹配 。 


前 面 在 if 语 句 中 通过 is 运 算 符 和 模式 匹配 的 方式 ， 对 于 var 模 式 来 说 整 
变 得 坚 无 意义 了 ， 因 为 var 模 式 总 能 成 功 匹 配 。var 横 式 的 最 大 用 处 是 和 
switch+ 哨 兵 语 句 〈12.6.1 节 将 介绍 ) 搭配 使 用 。var 模 式 偶尔 在 switch 搭 
配 更 复杂 的 表达 式 并 且 不 需要 给 变量 赋值 的 情况 下 有 使 用 价值 。 
代码 清单 12-16 和 代码 清单 12-11 类 似 ， 也 实现 了 一 个 Perimeter 方 法 。 这 
个 例子 有 意 避 免 使 用 哨兵 语句 特性 。 如 果 其 中 的 shape 参 数 的 值 
为 nul1， 就 会 随机 创建 一 个 形状 。 我 们 使 用 var 模 式 ， 当 无 法 计算 当前 
形状 的 周 长 时 ， 会 报告 这 一 形状 ， 因 为 这 一 次 不 会 遇 到 nul11 引 用 ， 因 此 
常量 模式 中 的 nul1 值 在 这 里 也 不 需要 了 。 

代码 清单 12-16 “ 当 遇 到 错误 时 ， 使 用 var 模 式 引 入 一 个 变量 


static double Perimeter(Shape shape) 

















Switch (shape ?3? CreateRandomShape( ) ) 


{ 
case Rectangle rect: 
return 2 * (rect.Height + rect.width); 
case Circle circle: 
return 2 * PI * circle.Radius; 
case Triangle triangle: 
return triangle.SideA + triangle.SideB + triangle.Ssid 
case var actualShape: 
throw new InvalidoperationException( 
$"Shape type {actualShape.GetType()} perimeter un 
} 


这 个 例子 还 有 一 种 写法 : 在 switch 语 名 前 引入 actualshape 变 量 ， 针 对 
actualshape 进 行 switch， 之 后 正常 使 用 default case。 


以 上 就 是 C# 7.0 引 入 的 所 有 模式 了 。 前 面 介绍 了 每 种 模式 的 语法 以 及 相 


应 的 使 用 场景 (在 smitch 语 句 中 搭配 is 运 算 符 ) ， 但 是 关于 每 种 场景 还 
有 一 些 内 容 需要 深入 讨论 ， 


12.5 ”模式 匹配 与 is 运 算 符 的 搭配 使 用 


is 运 算 符 可 以 用 作 任 何 普通 表达 式 的 一 部 分 ， 其 中 绝 大 部 分 是 和 if 语 句 
联 用 ， 但 if 语 句 并 不 是 其 唯一 搭档 。 在 C# 7 之 前 ，is 运 算 符 的 右 半 部 分 
必须 是 茶 个 类 型 ， 到 了 C# 7， 它 还 可 以 是 模式 。 虽 然 第 量 模式 和 var 模 
式 也 可 以 使 用 is 运 算 行 ， 但 实际 上 类 型 模式 是 其 最 常见 的 搭档 。 

var 模 式 和 类 型 模式 都 会 引入 新 变量 。 在 C# 7.3 之 前 ， 这 两 个 模式 都 有 一 
个 限制 条 件 : 新 变量 不 能 用 于 字段 、 属 性 、 构 造 器 初始 化 器 或 者 查询 表 
达 式 。 例 如 以 下 代码 非法 : 


static int length = GetObject() is string text ? text.Length : -1 


虽然 我 并 没有 和 觉得 这 项 限制 会 造成 什么 问题 ， 但 C# 7.3 还 是 将 其 取消 
Ts 



































这 种 引入 新 的 局 部 变量 的 模式 ， 会 引发 一 个 显而易见 的 问题 : 新 引入 的 
变量 ， 其 作用 域 多 大 呢 ? 这 个 问题 曾 在 C# 语 言 团队 和 社区 中 引起 了 大 量 
争论 ， 但 最 终 的 结果 是 : 该 变量 的 作用 域 局 限 在 财 合 块 中 。 





话题 之 所 以 会 出 现 激 烈 和 争论 ， 通 常 都 源 于 其 优 缺 点 并 存 。 代 码 清单 12- 
10 中 的 as/if 模 式 ， 有 一 点 我 一 直 不 太 喜 欢 : 这 种 方式 最 后 都 会 在 作用 域 
内 引入 一 扒 变 量 ， 但 是 除了 用 作 类 型 匹配 条 件 ， 其 实 并 不 需要 这 些 变 
量 。 然而， 这 依然 是 使 用 类 型 模式 的 一 个 现状 。 不 过 严格 说 来 ， 二 者 的 
问题 并 不 一 致 : 当 模 式 没 有 匹配 时 ， 变 量 在 分 文中 并 不 会 确定 赋值 。 


对 比 以 下 代码 : 
string text = input as string; 


if (text != null) 
{ 











Console.WriteLine(text); 


这 上 段 代码 执行 完成 之 后 ，text 变 量 依然 在 作用 域 中 ， 并 且 是 确定 赋值 
的 。 与 其 基本 等 价 的 类 型 模式 的 代码 如 下 : 


if (input is string text) 


Console.WriteLine(text); 


有 


这 段 代码 执行 完成 之 后 ，text 变 量 也 在 作用 域 中 ， 但 并 不 是 确定 赋值 
人 
， 例如 : 


if (input is string text) 





Console.writeLine("Input was already a string; using that"); 
} 
else if (input is StringBuilder builder) 


Console.writeLine("Input was a StringBuilder; using that"); 
text = builder.ToString( ); 


else 
{ 
Console.writeLinel( 
$"Unable to use value of type ${input.GetType()}. Enter 七 
text = Console.ReadLine( ); 


Console.writeLine($"Final result: {text}"); 


因为 代码 的 后 半 部 分 还 需要 用 到 text 变 量 ， 所 以 确实 需要 text 变 量 依然 
存活 于 当前 作用 域内 。text 变 量 最 终 会 从 两 种 赋值 条 件 中 选择 一 种 ， 虽 
然 中 间 部 分 的 builder 变 量 之 后 不 会 被 用 到 ， 但 它 依 然 存活 。 这 里 无 法 
做 到 尽善尽美 。 


关于 “确定 赋值 > 这 个 概念 ， 还 需 从 技术 层面 加 以 描述 : 在 is 表达 式 通过 
模式 引入 了 一 个 模式 变量 后 ， 该 变量 《使 用 语言 规范 中 的 术语 )“ 在 ture 
表达 式 之 后 ， 确 定 会 被 赋值 ">。 如 果 需 要 if 条 件 语句 完成 类 型 检查 之 外 
的 一 些 功 能 ， 这 一 点 非 党 重要。 假如 还 要 检查 该 值 是 售 是 一 个 比较 大 的 
整 型 数 ， 那 么 可 以 编写 如 下 代码 : 


if (input is int x && x > 100) 

















Console.writeLine($"Input was a large integer: {x}"); 








之 所 以 能 够 在 && 运 算 符 之 后 使 用 x 变量 ， 是 因为 只 有 在 第 1 个 操作 数 运算 
为 true 后 ， 才 会 对 第 2 个 操作 数 进 行 运算 。 同 样 ， 在 if 块 内 也 可 以 使 用 x 
变量 ， 因 为 只 有 在 && 两 个 操作 数 都 运算 为 true 后 ， 才 会 执行 jf 语句 内 的 
代码 。 如 果 需 要 同时 处 理 int 和 1ong 两 种 值 怎么 办 呢 ? 可 以 检查 这 些 
值 ， 但 是 无 法 确定 哪个 条 件 会 被 匹配 成 功 : 


if ((input is int x && x > 100) || (input is long y && y > 100)) 
{ 








Console.writeLine($"Input was a large integer of some kind"); 


这 段 代码 中 的 x 和 y 痢 在 当前 作用 域 中 ， 不 管 在 if 块 内 还 是 外 ， 即 使 y 的 
声明 看 上 去 不 会 被 执行 ， 但 是 这 两 个 变量 只 有 在 检查 其 大 小 的 那 一 小 块 
语句 中 ， 才 算是 “确定 赋值 ”的 。 


虽然 前 面 的 内 容 从 逻辑 上 讲 没什么 问题 ， 但 是 对 于 初学 者 来 说 可 能 有 些 
复 淋 。 这 部 分 内 容 可 归纳 为 以 下 两 点。 
。 在 is 表 达 式 中 声明 的 模式 变量 ， 其 作用 域 为 整个 闭合 块 。 
。 如 果 茶 处 使 用 模式 变量 的 代码 发 生 了 编译 错误 ， 则 说 明 在 此 处 编译 
融 还 无 法 确定 该 变量 是 否 已 经 被 赋值 。 


本 章 最 后 重点 探讨 如 何在 switch 语 句 中 使 用 模式 。 

















12.6 ”在 switch 语 句 中 使 用 模式 


语言 规范 通 闻 不 是 根据 算法 来 编写 的 ， 而 是 根据 各 种 使 用 场景 。 下 面 是 
儿 个 与 算法 无 天 的 实际 场景 。 


。 税 费 与 福利 一 一 纳税 额 可 能 取决 于 收入 和 其 他 因素 。 
让 可 能 会 有 团 票 折扣 ， 儿 童 、 成 人 和 老年 人 有 单独 的 票 


介 。 
。 外 卖 订单 一 一 当 订 单 满 足 一定 条 件 可 能 会 有 折扣 。 


以 前 有 两 种 方式 来 针对 特定 输入 进行 检查 ， 然 后 决定 应 用 哪 种 场 
景 : switch 语 句 和 if 语句 ， 其 中 switch 语 句 必须 使 用 简单 的 常量 。 如 今 
还 是 只 有 这 两 种 方式 ， 刚 刚 讲 了 if 语 句 的 使 用 ， 下 面 介绍 更 为 强大 的 


switch 语 人 句 。 


说 明 ”基于 模式 的 switch 语 句 和 以 前 只 能 使 用 和 常量 值 的 switch 语 句 
的 差异 较 大 。 如 果 读 者 没 接触 过 其 他 语言 的 类 似 功 能 ， 也 许 要 花 些 
时 间 适 应 。 


和 模式 搭配 使 用 的 switch 语 句 与 一 组 if/else 语 名 大致 等 价 ， 但 是 采 
用 switch 语 句 ， 会 让 我 们 看 竺 和 思考 代码 的 方式 更 接近 “这 类 输入 应 当 
对 应 这 类 输出 ”， 而 不 是 以 步骤 的 方式 思考 。 


所 有 switch 语 句 都 可 以 看 作 基 于 模式 


本 童 多 次 提 及 基于 常量 的 switch 语 句 和 基于 模式 的 switch 语 句 仿 
佛 二 者 是 不 同 的 。 常 量 模式 也 属于 模式 ， 每 条 switch 语 句 都 可 以 看 
作 基 于 模式 的 switch 语 句 ， 二 者 的 行为 模式 也 完全 一 致 。 不 过 二 者 
在 执行 顺序 和 新 变量 引入 上 存在 差异 ， 稍 后 介绍 。 


我 认为 ， 至 少 目 前 ， 可 以 把 这 两 者 看 作 恰 好 应 用 了 同一 语法 的 不 同 
构建 。 该 者 可 能 认为 应 该 将 二 者 同等 看 待 。 无 论 以 哪 种 方式 看 待 都 
可 以 ， 都 不 影响 对 代码 行为 的 判断 。 


12.3 节 展示 过 基于 模式 的 switch 语 句 ， 当 时 使 用 了 一 个 利 量 模式 来 匹 
配 nul1 值 ， 使 用 了 类型 模式 来 匹配 其 他 形状 。 为 了 方便 在 case 标 签 中 添 
加 模式 ， 还 需要 引入 新 语法 。 












































12.6.1 ”哨兵 语句 


每 个 case 标 签 都 可 以 有 一 条 哨兵 语句 ， 该 语句 由 一 个 表达 式 组 成 : 


case pattern when expression: 


该 表达 式 最 终 要 计算 出 一 个 布尔 值 2， 和 if 语 句 中 的 条 件 一 样 。case 标 
签 下 的 语句 ， 只 有 在 该 表达 式 计算 为 true 时 才 会 执行 。 该 表达 式 也 可 以 
使 用 模式 ， 这 样 会 引入 更 多 模式 变量 。 


2 也 可 以 是 一 个 能 隐 式 转换 为 布尔 类 型 的 值 ， 或 者 该 值 的 类 型 提供 了 
true 运 算 符 。 这 里 的 要 求 和 if 语 句 中 的 条 件 保持 一 致 。 


下 面 看 一 个 具体 的 例子 ， 这 个 例子 也 会 证 实 开头 关于 语言 规范 的 论断 。 
考 谍 如 下 裴 波 那 灸 数列 的 定义 : 








e。 fib(0) = 0 
e。 fib(1) = 1 
efib(n) = fib(n-2) + fib(n-1)， 当 n>1 时 


第 11 章 讲 过 如 何 使 用 元 组 来 生成 斐 流 那 句 数列 。 现 在 以 函数 的 眼光 来 看 
竺 裴 波 那 契 数列 ， 前 面 的 定义 吏 可 以 转换 成 代码 清单 12-17: 一 条 使 用 
了 模式 和 哨兵 语句 的 简单 switch 语 句 。 

代码 清单 12-17 ”使 用 模式 递归 实现 斐 波 那 娘 数列 


static int Fib(int n) 





switch (n) 




















case 0: return 0; (本 行 及 以 下 1 行 ) 常量 模式 处 理 前 两 种 情况 

case 1: return 1; 

case var _ when n > 1: return Fib(n - 2) + Fib(n - 1); <- 

default: throw new ArgumentOutofRangeException( (本 行 及 以 下 
nameof (Nn), "Input must be non-negative"); 

















小 


当然 ， 在 实际 工作 中 我 不 会 采用 这 种 方案 ， 因 为 它 的 执行 效率 极 低 ， 但 
它 生 动 地 展示 了 语言 规范 是 如 何 直 接 转 换 成 代码 的 。 


在 这 个 例子 中 ， 因 为 哨兵 语句 用 不 到 模式 变量 ， 所 以 我 们 把 该 变量 设 为 
丢弃 变量 ， 用 下 划 线 〈(_) 表示 。 在 很 多 情况 下 ， 如 果 模 式 引 入 了 新 变 
量 ， 新 变量 通常 需要 在 哨兵 语句 或 者 case 体 代码 中 使 用 。 


在 使 用 哨兵 语句 时 ， 同 一 模式 出 现 多 次 是 和 常事， 因为 当 第 一 次 模式 匹配 
后 ， 哨 兵 语句 有 可 能 会 返回 false。 下 面 这 段 代码 是 Noda Time 项 目 中 一 
个 用 于 构建 文档 的 工具 : 


private String GetUid(TypeReference type, bool useTypeArgumentNam 











switch (type) 


case ByReferenceType brt: 
return $"{GetUid(brt.ElementType, useTypeArgumentName 
case GenericParameter gp when useTypeArgumentNames: 
return gp.Name; 


case GenericParameter gp when gp.DeclaringType != null: 
return $". {gp.Position}"; 
case GenericParameter gp when gp.DeclaringMethod != null: 


return $". {gp.Position}"; 
case GenericParameter gp: 
throw new InvalidOperationException( 
"Unhandled generic parameter"); 
case GenericInstanceType git: 
return "(This part of the real code is long and irrel 


default: 
return type.FullName.Replace('/', '.'); 


. 


这 里 一 共 使 用 了 4 个 模式 来 处 理 泛 型 参数 ， 处 理 的 依据 

是 useTypeArgumentNames 方 法 参数 以 及 方法 /类 型 是 否 引 入 了 泛 型 类 型 形 
参 。 其 中 负责 抛 出 异常 的 case 差 不 多 等 同 于 泛 型 形 参 的 default case， 它 
表示 代码 进入 了 考虑 范围 之 外 的 区 域 。 请 注意 ， 代 码 中 不 同 的 case 使 用 
同一 个 模式 变量 名 (gp) 。 这 束 引 出 了 男 外 一 个 重要 的 问题 ， 在 case 标 
签 中 引入 的 模式 变量 的 作用 域 是 多 大 ? 


12.6.2 ” case 标签 中 的 模式 变量 的 作用 域 
如 果 在 case 体 中 直接 定义 局 部 变量 ， 那 么 该 变量 的 作用 域 是 整 条 switch 


语句 ， 包 括 其 他 case 体 在 内 。 这 个 规律 现在 依然 成 六 我 的 个 人 看 
法 ) ， 但 并 不 包括 在 case 标 签 中 声明 的 变量 。 这 些 变 量 的 作用 域 仅 限于 








当前 case 体 ， 由 模式 引入 的 模式 变量 、 在 哨兵 语句 中 声明 的 模式 变量 以 
及 out 变 量 (参见 14.2 节 ) 丝 是 如 此 。 


这 基本 上 正 是 我 们 所 需要 的 ， 在 多 个 case 中 处理 近似 情况 需要 采用 同一 
模式 的 变量 时 尤其 有 用 (参考 前 一 个 Noda Time 工 具 的 代码 ) 。 但 此 时 
会 有 一 个 问题 : 基于 模式 的 switch 语 句 应 当 和 普通 switch 语 句 一 样 ， 人 允 
许多 个 case 标 签 共享 同一 个 case 体 。 在 这 种 情况 下 ，case 标 签 中 声明 的 
变量 就 不 能 重 名 《因为 它们 处 于 一 个 声明 空间 下 ) 。 然 而 case 体 中 所 有 
的 模式 变量 都 不 是 确定 赋值 的 ， 因 为 编译 器 无 法 确定 会 匹配 到 哪个 标 

签 。 这 类 模式 变量 主要 用 于 哨兵 语句 中 ， 而 不 是 case 体 中 。 

假设 此 时 需要 为 一 个 object 类 型 的 输入 进行 模式 匹配 ，object 是 处 于 特 
定 范 围 内 的 数值 类 型 ， 并 且 该 范围 会 因 具 体 类 型 的 不 同 而 有 所 区 别 。 我 
们 可 以 使 用 类 型 模式 来 匹配 每 种 数值 类 型 ， 并 搭配 相应 的 哨兵 语句 。 代 
码 清单 12-18 列 举 了 int 和 1long 两 种 情况 ， 读 者 也 可 以 自行 扩展 。 

代码 清单 12-18 使 用 模式 ， 多 个 case 标 签 共享 一 个 case 体 


static void CheckBounds(object Input ) 

















switch (input) 


case int x when x > 1000: 

case long y when y > 10000L: 
Console.writeLine("Value is too large"); 
break; 

case int x when x < -1000: 

case long y when y < -10000L: 
Console.writeLine("Value is too low"); 
break; 

default: 
Console.writeLine("Value is in range"); 
break; 

} 
} 


在 哨兵 语句 中 ， 模 式 变 量 是 确定 赋值 的 ， 因 为 只 有 对 应 的 模式 匹配 成 功 

才 会 执行 到 哨兵 语句 。 虽 然 在 case 体 中 模式 变量 依然 存在 ， 但 它们 并 不 
人 
用 处 。 


过 去 基于 常量 的 switch 语 句 和 现在 基于 模式 的 switch 语 句 还 有 一 处 重大 











关 异 : 现在 case 语 句 的 顺序 会 影响 执行 结果 ， 以 前 则 不 会 。 
12.6.3 ”基于 模式 的 switch 语 句 的 运算 顺序 


绝 大 部 分 情况 下 ， 基 于 常量 的 switch 语 句 中 的 case 标 签 可 以 任意 排列 ， 
而 不 会 影响 代码 的 执行 行为 3。 因 为 每 个 case 标 签 都 只 匹配 一 个 常量 
值 ， 任 何 一 条 switch 语 句 中 case 标 签 中 的 常量 值 都 不 会 重复 ， 因 为 任何 
一 个 输入 值 最 终 都 只 能 匹配 至 多 一 个 case 标 签 。 但 是 对 于 模式 来 说 ， 情 
况 束 不 同 了 。 


3 唯一 的 例外 是 ， 某 个 case 体 中 使 用 的 变量 是 前 面 某 个 case 体 声明 的 。 
0 之 所 以 它 会 造成 问题 ， 是 因为 此 类 变量 共享 作 
用 域 。 


基于 模式 的 switch 语 句 的 逻辑 运算 顺序 可 以 概括 为 : 


。 每 个 case 标 签 都 按照 源码 的 顺序 进行 运算 ; 
。 只 有 当 所 有 case 标 签 都 经 过 运算 后 ，default 标 签 的 代码 才 会 被 执 
行 ， 与 default 标 签 在 switch 语 句 中 的 位 置 无 关 。 


提示 “虽然 无 论 default 标 签 在 何 处 ， 只 有 在 其 他 case 标 签 都 不 能 
匹配 的 情况 下 ， 其 内 部 代码 才 会 被 执行 ， 但 其 他 代码 阅读 者 可 能 不 
知道 这 一 点 。〔 实 际 上 ， 很 可 能 等 自己 回头 阅读 代码 时 也 会 态 记 这 
一 点 。) 如 果 总 是 把 default 标 签 放 在 switch 语 句 的 末尾 ， 代 码 的 
行为 逻辑 会 更 清晰 明了 。 
有 时 这 种 方式 不 会 造成 什么 问题 。 以 之 前 斐 波 那 契 数 列 的 方法 为 例 : 输 
入 值 总 共 分 为 0(、1 和 大 于 1 这 3 种 情况 ， 因 此 顺序 可 以 自由 调换 ， 但 在 
Noda Time 工 具 代 码 中 存在 4 种 情况 ， 必 须 认 真 检查 顺序 : 


case GenericParameter gp when useTypeArgumentNames: 
return gp.Name; 


























case GenericParameter gp when gp.DeclaringType != null: 
return $" {gp.Position}"; 
case GenericParameter gp when gp.DeclaringMethod != null: 


return $". {gp.Position}",; 
case GenericParameter gp: 
throw new InvalidOperationException(...); 


在 这 上 段 代 码 中 ， 只 要 useTypeArgumentNames 的 值 为 true， 就 需要 使 用 泛 


型 参数 (第 1 个 case) ， 与 其 他 case 无 和 关 。 第 2 个 和 第 3 个 case 是 互 斥 的 
(我 们 自己 知道 而 编译 器 不 知道 ) ， 因 此 这 两 个 的 顺序 无 关 紧要 。 最 后 
一 个 case 则 必须 要 放 到 最 后 ， 因 为 需要 当 输 入 值 是 GenericParameter 并 
且 其 他 case 都 不 匹配 时 才 抛 出 异 销 。 


这 里 编译 器 发 挥 了 作用 : 最 后 一 个 case 没 有 哨兵 语句 ， 因 此 如 果 类 型 模 
式 匹 配 成 功 ， 那 么 该 case 将 总 会 执行 ， 编 译 器 会 发 现 这 一 点 。 如 果 把 这 
个 case 放 在 其 他 具有 相同 模式 的 case 标 签 前 ， 编 译 器 束 会 知道 这 个 case 
会 屏蔽 其 他 case， 从 而 引发 编译 错误 。 


多 个 case 体 的 执行 只 有 一 种 方式 ， 而 且 和 使 用 频率 很 低 的 goto 语 句 相 
天 。 这 一 扣 也 适用 于 switch 语 句 ， 但 是 goto 语 句 只 能 使 用 常量 值 ， 而 
且 case 标 签 只 能 与 没有 哨兵 语句 的 值 关 联 。 例 如 不 能 goto 一 个 类 型 模 
式 ， 也 不 能 goto 一 个 依赖 哨兵 语句 结果 为 true 的 条 件 值 。 在 实际 编码 
中 ， 几 乎 没 人 在 switch 语 句 中 使 用 goto 语 名， 因此 这 一 限制 并 不 造成 问 


匮 。 


这 里 有 意 强调 逻辑 上 的 运算 顺序 。 虽 然 C# 编 译 器 可 以 把 所 有 switch 语 人 句 
转换 成 一 系列 if/else 语 句 ， 但 还 有 更 高 效 的 做 法 。 假 如 存在 同一 个 类 型 
的 多 个 类 型 模式 〈 匹 配 不 同 的 哨兵 语句 ) ， 那 么 可 以 对 该 模式 只 运算 一 
次 ， 然 后 依次 检查 各 条 哨兵 语句 。 类 似 地 ， 对 于 那些 没有 哨兵 的 常量 值 
(与 先前 C# 版 本 一 样 ， 依 然 需要 非 重 复 值 )， 编 译 嚣 可 以 在 做 完 隐 式 类 
型 检查 之 后 调用 IL switch 指 令 。 具 体 编译 器 会 采取 哪 种 优化 策略 ， 不 在 
本 书 的 讨论 范围 之 内 。 如 果 读 者 刚好 在 查看 菜 条 switch 语 句 的 了 代码 ， 
发 现 它 与 源码 看 起 来 很 不 同 ， 可 能 这 束 是 原因 了 。 


12.7 对 模式 特性 使 用 的 思 


下 面 探究 上 述 特性 的 最 佳 用 法 。 分 解 和 模式 匹配 这 两 个 特性 还 在 不 断 演 
进 ， 将 来 甚至 可 能 组 合成 一 个 新 特性 : 分 解 模 式 。 其 他 一 些 相关 潜在 特 
性 ， 例 如 编写 根据 模式 switch 来 返回 结果 的 表达 式 主体 方法 等 ， 都 会 影 
啊 这 些 特性 的 使 用 场景 。 第 15 章 将 讨论 C# 8 的 一 些 潜在 的 类 似 特性 。 


模式 匹配 只 是 实现 层面 的 问题 ， 即 便 过 度 使 用 也 无 伤 大 雅 。 如 果 党 得 模 
式 特性 没有 显著 增强 可 读 性 ， 完 全 可 以 切换 回 以 前 的 编码 风格 。 对 于 分 
解 特 性 ， 也 大 人 致 与 之 类 似 。 不 过 ， 如 果 在 API 中 添加 了 很 多 公共 的 
Deconstruct 方 法 ， 移 除 这 些 方 法 就 会 是 破坏 性 的 改动 了 。 












































除 此 以 外 ， 建 议 类 型 最 好 不 要 一 开始 就 设计 为 可 分 解 ， 就 像 大 部 分 类 型 
不 会 天 然 地 实现 Icomparable<T> 接 口 一 样 。 只 有 当 类 型 组 件 的 顺序 明确 
且 清晰 的 情况 下 才 为 其 添加 peconstruct 方 法 ， 例 如 坐标 、RGB 值 以 及 
其 他 一 些 天 然 共 有 层级 关系 的 数据 《比如 日 期 /时 间 等 ) ， 但 大 部 分 和 
业务 相关 的 实体 不 太 可 能 是 这 类 数据 。 例 如 线 上 销售 的 某 件 商品 ， 其 诸 
多 属性 不 太 会 有 明显 的 顺序 关系 。 


12.7.1 发 现 分 解 的 时 机 


分 解 特性 最 容易 应 用 于 元 组 数据 中 。 如 果 某 个 方法 调用 的 结果 是 一 个 元 
组 值 ， 而 且 对 返回 值 的 顺序 没有 要 求 ， 那 么 可 以 考虑 分 解 返 回 值 。 例 如 
0 
元 组 当中 。 


int[] values = { 2, 7, 3, -5, 1, 0, 10 }; 
var (min, max) = MinMax(values); 
Console.writeLine(min); 

Console .writeLine(max); 


非 元 组 类 型 的 分 解 操 作 的 应 用 场景 会 少 一 些 ， 但 如 末 需 要 处 理 空间 点 坐 
标 、 颜 色 、 日 期 /时 间 这 类 值 ， 尽 早 分 解 这 些 值 会 更 好 ， 不 然 之 后 每 次 

都 得 通过 属性 来 访问 。 当 然 ， 在 C# 7 分 解 特性 出 现 之 前 ， 也 能 够 分 解 

值 。 但 是 通过 分 解 操 作 ， 声 明 局 部 变量 可 以 更 简单 ， 这 也 是 分 解 特性 的 
一 项 目 身 优势 。 


12.7.2 ”发 现 模式 匹配 的 使 用 时 机 
以 下 两 个 场景 可 考虑 使 用 模式 匹配 : 


。 使 用 is 运算 符 或 者 as 运算 符 ， 并 且 用 特定 类 型 值 作 为 条 件 的 位 置 ; 
e。 大 量 使 用 if/else-if/else-if/else， 并 且 使 用 同一 个 值 作为 条 件 的 
位 置 ， 可 以 使 用 swtich 语 句 来 代替 。 


如 打发 现 var ..，when 模 式 多 次 出 现 《〈 换 言 之 ， 唯 一 条 件 出 现在 哨兵 语 
句 中 ) ， 就 需要 思考 这 是 否 是 真正 的 模式 匹配 。 我 兽 遇 到 过 类 似 的 情 

景 ， 而 且 在 选择 使 用 模式 匹配 时 犯 过 错 。 在 我 看 来 ， 就 算是 略微 过 度 使 
用 模式 匹配 ， 也 是 可 以 接受 的 ， 因 为 它 可 以 将 “匹配 茶 个 条 件 然后 执行 
菏 个 操作 ”的 意图 表达 得 更 清晰 明确 ， 好 于 各 干 个 if/else。 




















以 上 两 个 特性 都 是 在 实现 细 市 层面 对 已 有 代码 做 的 变形 。 它 们 并 不 会 改 
变 我 们 思考 问题 和 组 织 逻 辑 的 方式 ， 不 过 有 些 更 为 宏观 的 变化 其 实 更 难 
发 现 〈 例 如 单个 类 型 的 API 内 部 重 构 ， 或 是 东 个 程序 集 公 共 API 的 内 部 
重 构 ) 。 有 时 这 个 变化 可 能 是 移 除 一 处 继承 ， 例 如 一 套 运 算 逻 辑 ， 原 先 
作为 类 型 实现 的 一 部 分 ， 之 后 可 能 优化 成 为 单独 的 运算 逻辑 与 类 型 进行 
分 离 ， 例 如 12.3 市 中 计算 各 种 形状 周 长 的 代码 。 也 可 以 把 类 似 的 方法 应 
用 于 很 多 业务 场景 中 ， 这 也 是 C# 中 类 型 组 合 的 方式 日 渐 受 欢迎 的 一 个 原 
因 。 


以 上 是 一 些 粗略 的 个 人 见解 ， 希 望 大 家 多 多 练习 和 思考 ， 在 编码 的 同时 
思考 这 些 特性 可 用 于 何 处 ， 并 在 试用 新 特性 之 后 思考 该 特性 的 优 缺 点 。 











12.8 小结 


。 利用 分 解 特性 ， 可 以 拆 分 出 多 个 值 到 独立 变量 中 。 分 解 操作 的 语法 
对 于 元 组 类 型 和 非 元 组 类 型 是 一 致 的 。 

e。 非 元 组 类 型 可 以 通过 带 有 out 人 参数 的 peconstruct 方 法 进行 分 
解 。Deconstruct 方 法 可 以 是 实例 方法 ， 也 可 以 是 扩展 方法 。 


。 使 用 var 前 置 的 分 解 操作 ， 可 以 声明 多 个 变量 ， 前 提 是 编译 右 可 以 
推断 出 这 些 变量 的 类 型 。 


。 模式 匹配 可 以 检查 东 个 值 的 类 型 和 内 容 ， 部 分 模式 还 可 以 声明 新 变 
量 。 














。 模式 匹配 可 以 和 is 运算 符 搭 配 使 用 ， 或 者 用 于 switch 语 句 中 。 

。 switch 语 句 中 的 模式 可 以 添加 额外 的 哨兵 语句 ， 哨 兵 语 句 由 when 上 
下 文 关键 字 引 入 。 

0 





第 13 章 引用 传 迎 提升 执 行 效率 
本 章 内 容 概览 


。 使 用 ref 关 键 字 为 变量 起 别名 ; 

。 使 用 ref 通 过 引用 返回 变量 ; 

。 使 用 in 参数 提升 实 参 传递 效率 ; 

。 使 用 只 读 ref retum、 只 读 ref 局 部 变量 和 只 读 结 构 体 声明 来 防 
止 数据 修改 ; 

e。 使 用 in 或 者 ref 的 扩展 方法 ; 


。 类 ref 结 构 体 和 span<T>。 


C# 7.0 刚 推出 的 时 候 ， 其 中 两 个 新 特性 着 实 令 人 惊异 : ref 局 部 变量 和 
ref returmn。 我 怀疑 到 底 会 有 多 少 开 发 人 员 用 到 这 两 项 特性 ， 因 为 它们 像 
是 针对 大 数据 类 型 设计 的 ， 而 这 种 场景 很 少见 。 我 当时 预计 只 有 准 实时 
的 服务 和 游戏 才 会 用 到 它们 。 


C# 7.2 还 引入 了 和 ref 有 关 的 一 些 特 性 : in 参数 、 只 读 ref 局 部 变量 和 只 
读 ref return、 只 读 结 构 体 以 及 类 ref 结 构 体 。 虽 说 它们 只 是 对 C# 7.0 特 性 
的 一 些 补充 ， 但 似乎 为 了 少数 用 户 而 把 语言 变 得 更 复杂 了 。 


现在 我 终于 明白 了 ， 即 便 很 多 工程 中 没有 多 少 基于 ref 的 代码 ， 但 由 于 
这 些 特 性 的 存在 ， 开 发 人 员 实 际 上 还 是 受 痊 了 ， 因 为 有 高 性 能 
framewotk 工 具 可 用 。 在 本 书 编写 之 时 ， 还 很 难 各 定 地 说 这 些 特性 将 带 
来 革命 性 的 变化 ， 但 我 认为 其 影响 会 很 深远 。 


性 能 提升 通常 会 导致 代码 可 读 性 变 莽 ， 即 将 介绍 的 很 多 特性 便 古 如 此 。 
建议 在 明确 强调 性 能 的 场景 中 应 用 这 些 特 性 ， 这 样 可 读 性 的 牺牲 才 是 值 
得 的 。 不 过 可 以 尽情 使 用 那些 已 经 应 用 了 新 特性 的 framework， 它 们 能 
全 减轻 内 存 和 垃圾 回收 器 的 工作 ， 同 时 保持 代码 
I 可 读 性 。 


之 所 以 讲 这 些 ， 是 考虑 到 读者 可 能 会 有 类 似 的 体会 。 在 阅读 本 章 时 ， 读 
者 完全 有 理由 不 采用 这 些 新 特性 ， 可 直接 跳 转 至 章 尾 ， 了 解 新 特性 带 给 
framework 的 相关 益处 。 本 章 最 后 讨论 类 ref 结 构 体 和 span<T> 类 型 。 关 于 





























span 话 题 ， 有 很 多 内 容 可 讲 ， 但 远 远 超出 了 本 书 可 容纳 的 体 量 。 我 认为 
span 和 一 些 相 关 类 型 将 来 会 成 为 日 常 开发 工具 。 


本 章 还 会 讨论 一 个 仅 在 C# 7 版 本 中 出 现 的 定点 特性 。 与 其 他 定点 特性 类 
似 ， 如 果 使 用 C# 7 编译 器 ， 那 么 只 有 在 将 工程 设置 到 特定 语言 版 本 之 
后 ， 才 能 使 用 该 项 特性 。 对 于 ref 相 关 特 性 ， 建 议 设置 好 之 后 全 面 应 
用 ， 或 者 一 处 都 不 用 。 只 使 用 C# 7.0 的 特性 一 定 是 远 远 不 够 的 。 下 面 首 
先 回顾 早期 C# 版 本 中 ref 关 键 字 的 用 法 。 





13.1 回顾: ref 知 多 少 


要 理解 C# 7 的 ref 特 性 ， 需 要 认真 回顾 C# 6 以 前 版 本 中 ref 参 数 的 工作 原 
理 ， 首 先是 变量 和 值 之 间 的 区 别 。 


对 于 变量 这 个 概念 的 理解 因 人 而 异 。 可 以 把 变量 想象 成 一 张 纸 ， 如 图 
13-1 所 示 。 这 张 纸 上 共有 3 项 信息: 


。 变 量 的 名 称 ; 
。 编 译 时 类 型 
。 当 前 值 








图 13-1 把 变量 想象 成 一 张 纸 


给 变量 赋 新 值 ， 束 相当 于 探 挥 当前 值 然 后 写 上 一 个 新 值 。 当 变量 类 型 是 
引用 类 型 时 ， 纸 上 所 写 的 值 就 不 再 是 对 象 本 里 ， 而 是 对 象 的 引用 。 对 象 
的 引用 ， 束 是 通过 地 址 找到 对 象 ， 就 像 通过 街道 地 址 找到 茶 个 建筑 一 

样 。 如 果 两 张 纸 上 写 着 相同 的 地 址 ， 那 么 这 两 个 地 址 指向 同一 个 建筑 ; 

两 个 引用 值 相 同 的 变量 ， 指 向 的 是 同一 个 对 象 。 





提示 ref 关键 字 和 对 象 引用 是 不 同 的 概念 。 虽 然 二 者 有 相似 性 ， 

但 需要 加 以 区 分 。 通 过 值 传递 对 象 引 用 和 通过 引用 传递 变量 是 不 同 

的 。 下 面 过 使 用 对 象 引用 而 不 是 引用 来 重点 区 分 这 两 个 概念 。 

当 把 菜 个 变量 值 复制 给 为 外 一 个 变量 时 ， 只 是 这 个 值 本 身 发 生 了 复制 。 
这 两 张 纸 依然 是 独立 的 两 张 纸 ， 之 后 任何 一 个 变量 的 值 改变 都 不 会 影响 
为 外 一 个 变量 ， 见 图 13-2。 








图 13-2 ”把 值 赋 给 一 个 新 变量 


这 种 方式 的 值 复制 ， 和 调用 方法 时 对 值 参 数 的 操作 是 相同 的 ， 方法 实 参 
的 值 被 复制 到 了 男 一 张 新 纸 上 一 一 形 参 中 ， 如 图 13-3 所 示 。 实 参 可 以 是 
变量 ， 也 可 以 是 任何 适当 类 型 的 表达 式 。 





使 用 值 参数 调用 方法 : 方法 形 参 是 新 变量 ， 其 初始 值 是 实 参 
Re] 


但 ref 参 数 的 行为 与 此 不 同 ， 见 图 13-4。 使 用 ref 参 数 ， 不 会 创建 一 张 新 
纸 ， 而 是 由 调用 方 提供 一 张 现 有 的 、 包 含 初始 值 的 纸 。 可 以 将 其 看 作 一 
a 
参 名 称 。 





图 13-4 ref 参数 使 用 同一 张 纸 ， 而 不 是 创建 一 张 新 纸 并 复制 值 


如 果 在 方法 中 修改 了 ref 参 数 的 值 ， 即 修改 了 纸 上 的 现 有 值 。 当 方法 返 

回 时 ， 修 改 的 结果 就 会 反应 给 调用 方 ， 因 为 修改 的 是 同一 张 纸 上 的 值 。 
说 明 看 竺 形 参 和 变量 的 方式 有 多 种 。 茶 些 作者 提出 了 不 同 的 理解 
方式 : 把 ref 参 数 看 作 完 全 独立 的 变量 ， 它 有 一 个 上 自动 的 中 间 层 ， 
任何 关于 ref 参 数 的 访问 都 会 先 访问 中 间 层 。 这 种 解释 更 接近 IL 的 
工作 原理 ， 但 对 我 来 说 帮助 不 大 。 

此 外 ， 并 不 是 每 个 ref 参 数 都 会 使 用 不 同 的 纸 。 下 面 这 个 例子 有 些 极 

端 ， 但 有 助 于 我 们 理解 ref 参 数 ， 以 及 接 下 来 要 讲 的 ref 局 部 变量 。 


代码 清单 13-1 多 个 ref 参 数 使 用 同一 个 变量 


static void Main() 





int x = 5; 
InNncrementAndDouble(ref x, ref x); 
Console .writeLine(x); 


l 


static void IncrementAndDouble(ref int pi, ref int p2) 


pl++; 
p2 “= 2; 
} 


这 段 代码 的 执行 结果 是 12，x、p1l、p2 表 示 的 是 同一 张 纸 。 这 张 纸 上 的 


初始 值 是 5，pl++ 把 它 变 成 6， 然 后 p2 *= 2 把 6 翻 倍 变 成 12。 图 13-5 展 示 
了 上 述 过 程 。 


图 13-5 ”两 个 ref 参 数 指向 同一 张 纸 


一 种 常见 的 做 法 是 把 它们 看 作 别 名 : 变量 x、p1 和 p2 都 是 同一 个 存储 位 
置 的 别名 ， 它 们 只 是 通 往 同 一 块 内 存 的 不 同方 式 而 已。 


上 述 内 容 可 能 略 显 陈旧 、 烦 琐 ， 但 这 是 在 为 接 下 来 C# 7 真正 的 新 特性 做 
知识 铺垫 。 以 纸张 作为 思维 模型 来 理解 变量 ， 便 于 学 习 新 特性 。 








13.2 ”ref 局 部 变量 和 ref return 


C# 7 中 ref 的 很 多 相关 特性 是 相互 关联 的 。 如 果 逐 个 介绍 ， 很 难 体现 出 
这 些 特性 的 优势 。 在 描述 这 些 特性 时 ， 给 出 的 代码 示例 也 会 比 一 般 例子 
看 起 来 更 刻意 ， 则 在 一 次 只 展示 一 个 特性 点 。 下 面 介绍 C# 7.0 引 入 的 两 
个 特性 ， 二 者 在 C# 7.2 中 有 所 增强 。 首 先 介绍 ref 局 部 变量 。 





13.2.1 ref 局 部 变量 


沿用 前 文中 的 模型 .ref 参数 可 以 让 两 个 方法 中 的 变量 共享 同一 张 纸 ， 
即 调用 方 和 被 调用 方 参数 所 使 用 的 是 同一 张 纸 。ref 局 部 变量 则 进一步 








扩展 了 上 述 特性 : 可 以 声明 一 个 新 的 局 部 变量 ， 该 局 部 变量 和 一 个 已 有 
变量 共享 同一 张 纸 。 


代码 清单 13-2 给 出 了 简单 的 例子 ， 其 中 两 个 变量 分 别 自 增 1， 然 后 打印 
结果 。 请 注意 ， 在 变量 声明 和 变量 初始 化 时 都 需要 使 用 ref 关 键 字 。 


代码 清单 13-2 ”通过 两 个 变量 自 增 两 次 

















int x = 10; 

ref int y = ref x; 
X++， 

yt+, 


Console.writeLine(x); 
执行 结果 是 12， 就 像 x 自 增 了 两 次 。 


任何 具有 合适 类 型 的 表达 式 ， 如 果 可 以 被 看 作 变 量 ， 就 可 用 于 初始 
化 ref 局 部 变量 ， 例 如 数组 元 组 。 假 设 有 一 个 可 变 的 大 型 数组 ， 震 要 批 
量 修 改元 素 ， 那 么 使 用 ref 局 部 变量 可 以 避免 不 必要 的 复制 操作 。 代 码 
清单 13-3 创 建 了 一 个 元 组 数组 ， 然 后 针对 每 个 数组 元 系 都 修改 其 中 的 元 
组 元 率 。 该 过 程 不 涉及 任何 复制 。 


代码 清单 13-3 ”使 用 ref 局 部 变量 修改 数组 元 素 


var array = new (int x, int y)[10]; 





for (int i = 0; i < array.Length; i++) (本 行 及 以 下 3 行 ) 使 用 (0, 0)，( 


array[i] = (i, 1i); 


for (int i = 0; i < array.Length; i++) (本 行 及 以 下 4 行 ) 对 于 数组 中 的 每 - 
{ 

ref var element = ref arrayl[il]; 

element .x++; 

element.y *= 2; 


在 ref 局 部 变量 出 现 之 前 ， 修 改 数组 有 两 种 方式 。 一 种 是 使 用 多 个 数组 
访问 表达 式 : 


for (int i = 0; i < array.Length; i++) 


array[il].x++; 
array[il.y *= 2; 


为 一 种 是 先 把 数组 中 的 每 个 元 组 复制 出 来 ， 修 改 完成 后 再 复制 回去 : 


for (int i = 0; i < array.Length; i++) 


{ 
var tuple = array[i]; 
tuple.x++; 
tuple.y *= 2; 
array[I] = tuple; 


这 两 种 方式 都 不 太 好 。 使 用 ref 局 部 变量 ， 即 可 在 循环 体内 部 把 数组 元 
素 用 作 普 通 变 量 。 

ref 局 部 变量 也 可 以 用 于 字段 。 静 态 字段 的 行为 可 预知 ， 实 例 字 段 的 行 
为 则 不 一 定 。 代 码 清单 13-4 创 建 了 一 个 ref 局 部 变量 ， 该 变量 通过 变量 
obj 成 了 茶 个 字段 的 别名 ， 然 后 把 obj 的 值 改 成 指 同 男 一 个 实例 。 

代码 清单 13-4 ”使 用 ref 局 部 变量 为 一 个 对 象 的 字段 取 别 名 


class RefLocalField 





























{ 
private int value; 
static void Main() 
{ 
var obj = new RefLocalField(); <------ 创建 RefLocalField 的 
ref int tmp = ref obj.value; <------ 声明 一 个 ref 局 部 变量 ， 指 | 
tmp = 10; <------ 为 ref 局 部 变量 赋 新 值 
Console.writeLine(obj.value); <------ 显示 0bj 字 上 段 的 值 被 修改 J 
obj = new RefLocalField(); <------ 0bj 变 量 重新 指向 RefLocalF 
Console.writeLine(tmp); <------ 显示 tmp 依 然 指向 第 1 个 实例 的 字 中 
Console.WriteLine(obj,value); <------ 显示 第 2 个 实例 的 字段 值 是 
} 
} 
执行 结果 如 下 : 
10 


10 


0 


中 间 这 行 结果 可 能 出 人 意料 ， 它 显示 使 用 tmp 并 非 每 次 都 等 价 于 使 
用 obj.value。tmp 只 是 在 初始 化 时 充当 obj.value 的 别名 。 图 13-6 是 Main 
方法 结束 时 变量 和 对 象 的 一 个 快照 。 





图 13-6 ”在 代码 清单 13-4 末 尾 ，tmp 变 量 指 向 第 一 个 实例 创建 后 的 字 
段 ， 而 obj 指 问 男 外 一 个 实例 


最 终结 果 是 ，tmp 变 量 将 阻 正 第 一 个 实例 被 垃圾 回收 ， 直 到 tmp 不 再 被 当 
0 
垃圾 回收 。 


说 明 ”使 用 ref 变 量 指 问 对 象 字 段 或 者 数组 元 系 ， 会 让 垃圾 回收 器 
的 工作 变 得 更 加 复杂 。 世 圾 回收 器 需要 辨别 该 变量 对 应 的 对 象 ， 然 
后 保留 该 对 象 。 一 般 的 对 象 引 用 比较 简单 ， 因 为 它们 能 直接 判断 出 
所 引用 的 对 象 。 对 于 对 象 而 言 ， 每 增加 一 个 指 回 其 字段 的 ref 变 
量 ， 垃 圾 回收 帮 所 维护 的 数据 结构 束 会 增加 一 个 内 部 指针 。 如 果 同 
时 出 现 很 多 这 种 变量 ， 代 价 惑 会 随 之 高 绘 。 好 在 ref 变 量 只 会 出 现 
在 栈 内 存 中 ， 不 大 可 能 造成 性 能 问题 。 














使 用 ref 局 部 变量 时 有 一 些 限制 条 件 ， 其 中 大 部 分 比较 明显 ， 没 有 太 大 
影响 ， 但 还 是 有 必要 了 解 一 下 ， 人 免得 浪费 时 间 想 迁 回 办 法 。 


1. 初始 化 :只 在 声明 时 初始 化 一 次 (在 C#7.3 之 前 ) 
ref 局 部 变量 必须 在 声明 时 完成 初始 化 ， 例 如 以 下 代码 非法 : 
int x = 10; 


ref int invalid; 
invalid = ref int x; 


同样 ， 也 不 能 把 东 个 ref 局 部 变量 变 成 其 他 变量 的 别名 《以 前 面 的 

模型 为 例 : 不 能 把 当前 纸 上 的 名 字 擦 挥 ， 然 后 把 名 字 写 在 为 一 张 纸 
上 ) 。 当 然 ， 同 一 个 变量 可 以 多 次 声明 。 例 如 在 代码 清单 13-3 中 ， 

可 以 在 循环 中 声明 元 素 变 量 : 


for (int i = 0; i < array.Length; I++) 








ref var element = ref array[il]; 


} 
每 一 次 循环 碗 代 中 ，element 都 会 成 为 不 同 数 组 元 素 的 别名 ， 因 为 
每 次 达 代 部 是 一 个 新 变量 。 


用 于 初始 化 ref 局 部 变量 的 变量 也 必须 是 已 经 赋值 的 。 读 者 可 能 认 
为 变量 应 当 共 至 “确定 赋值 ”的 状态 ， 但 C# 语 言 设计 团队 并 不 想 
把 “确定 赋值 ?的 规则 变 得 更 复杂 ， 因 此 只 需要 确保 ref 局 部 变量 总 
是 确定 赋值 的 即 可 ， 例 如 : 


int x; 

ref int y = ref x; <------ 非法 ， 因 为 x 并 不 是 确定 赋值 的 
x = 10; 

Console.writeLine(y); 


里 然 这 段 代码 在 所 有 变量 都 确定 赋值 后 才 去 读 取 变 量 的 内 容 ， 但 依 
然 是 非法 的 。 


C# 7.3 取 消 了 重新 赋值 这 项 限制 ， 但 是 ref 局 部 变量 必须 在 声明 时 赋 
值 的 限制 仍然 存在 ， 例 如 : 









































lnt x = 10; 

int y = 20; 

ref int r = ref x; 

r++; 

r = ref y; <------ 只 在 C# 7 .3 中 合法 

rt+; 

Console.WriteLine($"x={x}; y={y}"); <------ 打印 : x=11; y=21 


使 用 该 特性 当 慎 之 又 导 。 如 果 需 要 在 菏 个 方法 中 使 用 同一 个 ref 变 
量 来 指 代 不 同 的 变量 ， 重 构 一 下 方法 会 更 好 ， 使 之 更 简单 。 





. 没有 ref 字 段 ， 也 没有 超出 方法 调用 范围 的 ref 局 部 变量 


虽然 ref 局 部 变量 可 以 使 用 字段 来 进行 初始 化 ， 但 是 不 能 把 字段 声 
明 为 ref 字 段 。 这 也 是 为 了 防止 用 于 初始 化 ref 变 量 的 变量 的 生命 周 
期 比 ref 变 量 短 。 假 设 创 建 了 一 个 对 象 ， 访 对象 的 茶 个 字段 是 当前 
方法 局 部 变量 的 别名 ， 那 么 如 果 方 法 返回 了 ， 这 个 字段 该 怎么 处 理 
呢 ? 


在 以 下 3 个 场景 中 同样 需要 关注 局 部 变量 的 声明 周期 问题 


o 迭代 器 块 中 不 能 有 ref 局 部 变量 ; 

o async 方 法 不 能 有 ref 局 部 变量 ; 

o ref 局 部 变量 不 能 被 匿名 方法 或 者 局 部 方法 捕获 。 (第 14 章 将 
讨论 局 部 方法 的 概念 。 ) 


以 上 几 种 情况 都 是 局 部 变量 生命 周期 长 于 原始 方法 调用 的 情况 。 虽 
然 有 时 可 以 让 编 诺 器 来 做 判断 ， 但 是 语言 规则 还 是 选择 简单 优先 。 
(一 个 简单 的 例子 : 一 个 局 部 方法 只 会 被 定义 它 的 方法 调用 ， 而 不 
会 用 于 方法 组 转换 中 。 ) 





























. 只 读 变 量 不 能 有 引用 

C# 7.0 中 的 ref 局 部 变量 都 必须 是 可 写 的 ; 可 以 在 这 张 纸 上 写 新 的 
值 。 如 果 用 一 张 不 可 写 的 纸 来 初始 化 某 个 ref 局 部 变量 ， 就 会 导致 
问题 。 考 虑 以 下 违反 readonly 修 饰 符 的 代码 : 


class MixedVariables 








private int writableField; 
private readonly int readonlyField; 


public void TryIncrementBoth() 








ref int x = ref writableField; <------ 为 一 个 可 写字 段 取 】 
ref int y = ref readonlyField; <------ 为 一 个 只 读 字段 取 3 
Xx++; (本 行 及 以 下 1 行 ) 对 两 个 变量 分 别 做 自 增 

YE 


} 
} 


如 果 以 上 代码 可 行 ， 那 么 这 些 年 建立 起 来 的 关于 只 读 字 段 的 所 有 基 
础 都 将 朋 塌 。 季 好 编译 器 会 像 阻止 任何 对 readon1yField 变 量 的 直 
接 修改 一 样 ， 阻 止 上 面 的 赋值 操作 。 如 采 这 段 代 码 位 于 
Mixedvariables 类 的 构造 右 中 ， 就 是 合法 的 了 ， 因 为 在 构造 右 中 可 
以 癌 readonlyField 直 接 写 入 。 人 简 而 言 之 ， 创 建 一 个 变量 的 ref 局 部 
变量 的 前 提 是 : 该 变量 在 其 他 情况 下 可 以 正常 写 入 。 该 规则 与 C# 
1.0 中 的 ref 参 数 相 同 。 

如 林 只 想 利用 ref 局 部 变量 共 孚 方面 的 特性 而 个 需要 写 入 ， 这 项 限 


制 会 比较 棘手 。 不 过 C# 7.2 针 对 这 一 问题 提供 了 一 个 解决 方案 〈 参 
见 13.2.4 节 ) 。 














. 类 型 : 只 人 允许 一 致 性 转换 

ref 局 部 变量 的 类 型 ， 必 须 和 用 于 初始 化 它 的 变量 的 类 型 一 致 ， 或 
者 这 两 个 类 型 之 间 必 须 存 在 一 致 性 转换 ， 任 何其 他 类 型 的 转换 都 不 
行 ， 包 括 引 用 转换 这 种 其 他 场景 中 允许 的 转换 。 代 码 清单 13-5 展 示 
了 一 个 ref 局 部 变量 声明 ， 使 用 了 基于 元 组 的 一 致 性 转换 。 


说 明 关于 一 致 性 转换 ， 参 见 11.3.3 节 。 


代码 清单 13-5 ref 局 部 变量 声明 中 的 一 致 性 转换 


(int x, int y) tuple1 = (10, 20); 


ref (int a, int b) tuple2 = ref tuplel; 
tuple2.a = 30; 
Console.writeLine(tuplel1.x); 


这 段 代 码 的 执行 结果 是 30， 因 为 tuple1 和 tuple2 共 享 同 一 个 内 存 位 
置 。tuple1.x 和 tuple2.a 是 等 价 的 ，tuplel.y 和 tuple2.b 也 是 等 价 


的 。 


前 面 讲 了 局 部 变量 、 字 段 和 数组 元 素 都 可 以 用 于 初始 化 ref 局 部 变 
量 。 在 C# 7 中 ， 有 一 种 新 的 表达 式 可 以 归 类 到 变量 : 方法 通过 ref 








返回 的 变量 。 
13.2.2 ref return 


套用 前 面 的 思维 模型 来 理解 ref return 会 比较 容易 : 方法 除了 可 以 返回 
值 ， 还 可 以 返回 一 张 纸 。 需 要 在 返回 类 型 和 返回 语句 前 添加 ref 关 键 
字 ， 调 用 方 也 需要 声明 一 个 ref 局 部 变量 来 接收 返回 值 。 这 意味 着 需要 
在 代码 中 显 式 呈现 ref 关 键 字 ， 才 能 明确 表达 意图 。 代 码 清 单 13-6 展 示 
了 ref retum 的 一 个 简单 用 途 。RefReturn 方 法 将 传 入 的 值 返 回 。 


代码 清单 13-6 ref returm 的 简单 示例 


static void Main() 











{ 
int x = 10; 
ref int y = ref RefReturn(ref x); 
y+ 十 7 
Console.writeLine(x); 
} 
static ref int RefReturn(ref int p) 
{ 


return ref p; 


结果 是 11， 因 为 x 和 y 在 同一 张 纸 上 。 因 此 上 述 方法 等 价 于 : 


ref int y = ref x; 


本 可 以 把 这 个 方法 写成 表达 式 主体 方法 ， 但 这 里 还 是 保留 方法 原貌 ， 则 


在 清晰 展示 返回 部 分 。 











目前 看 还 算 简单 ， 但 后 面 还 有 很 多 细节 需要 讨论 : 编译 器 必须 确保 方法 
在 结束 之 后 ， 它 所 返回 的 纸 依然 存在 ， 因 此 这 张 纸 不 能 是 在 方法 内 部 创 
建 的 。 


用 实现 层面 的 术语 表述 惑 是 ， 方 法 不 能 返回 在 栈 内 存 上 创建 的 位 置 ， 
为 当 栈 内 存 弹 出 后 ， 这 个 内 存 位 置 就 不 再 有 效 了 。 在 描述 C# 语 言 的 工作 
原理 时 ，Eric Lippert 喜 欢 把 栈 看 作 实 现 细节 〈 人 参考 “The Stack Is An 
Implementation Detail Part One”) 。 这 个 例子 所 体现 的 就 是 一 个 实现 细 
节 在 语言 当中 的 渗透 。 这 项 限制 和 不 能 有 ref 字 上 段 的 限制 的 原因 相同 ， 
知晓 其 一 ， 便 能 把 相同 的 逻辑 应 用 于 另外 一 个 。 


这 里 不 会 给 出 可 以 /不 可 以 使 用 ref return 语句 的 变量 类 型 的 完整 列表 ， 
仅 给 出 一 些 和 常见 的 例子 。 














1. 可 以 
9 ref 或 者 out 参 数 。 
o。 引用 类 型 的 字段 。 
o。 结构 体 的 字段 〈 当 结构 体 变 量 是 ref 或 者 out 参 数 时 ) 。 
o 数组 元 素 。 
2. 不 可 以 





。 在 方法 内 部 声明 的 局 部 变量 〈 包 括 值 类 型 的 参数 ) 。 
o 在 方法 中 声明 的 结构 体 的 字段 。 


除了 上 述 规则 ， 在 async 方 法 和 迭代 器 块 中 也 完全 不 允许 使 用 ref 
return。 与 指针 类 型 相似 ， 不 能 将 ref 修 饰 符 用 于 类 型 实 参 (但 ref 可 以 
用 于 接口 和 委托 声明 中 ) ， 例 如 以 下 代码 完全 合法 : 
delegate ref int RefFuncInt32() 
但 Func<ref int> 是 非法 的 。 
ref retum 并 非 必须 和 ref 局 部 变量 搭配 使 用 。 如 果 只 需要 对 返回 结果 执 
行 简单 操作 ， 直 接 操作 即 可 。 人 代码 清单 13-7 是 代码 清单 13-6 的 变形 ， 没 
有 使 用 ref 局 部 变量 。 

代码 清单 13-7 ”把 ref return 的 结果 直接 进行 自 增 


static void Main() 


int x = 10; 
RefReturn(ref x)++; <------ 直接 对 返回 值 做 自 增 
Console.WriteLine(x); 





} 
static ref int RefReturn(ref int p) 


return ref p; 


} 


再 次 强调 ， 这 上段 代码 和 直接 将 x 和 目 增 是 等 价 的 ， 因 此 结果 是 11。 除 了 可 
以 直接 修改 结果 变量 ， 还 可 以 将 其 用 作 另 一 个 方法 调用 的 实 参 ， 例 如 调 
用 RefReturn 方 法 上 自身 〈 两 次 ) 作为 参数 : 


RefReturn(ref RefReturn(ref RefReturn(ref x)))++; 


ref return 也 可 以 用 于 索引 器 。 和 常见 用 法 是 通过 引用 方式 返回 数组 元 素 ， 
见 代 码 清单 13-8。 


代码 清单 13-8 ref returm 索 引 器 对 外 暴露 数组 元 素 


class ArrayHolder 














private readonly int[] array = new int[10]; 
public ref int this[int index|] => ref array[Index]; <------ 过 


} 
static void Main() 
ArrayHolder holder = new ArrayHolder(); 


ref int x = ref holder[0]; (本 行 及 以 下 1 行 ) 定义 两 个 ref 局 部 变量 指 癌 | 
ref int y = ref holder[0]; 














X = 20; <------ 通过 x 修改 数组 元 素 值 
Console.WriteLine(y); <------ 通过 y 检 查 元 素 修 改 结果 











} 


C# 7.0 的 所 有 新 特性 已 介绍 完毕 ， 而 之 后 的 定点 版 本 扩展 了 ref 相 关 特 
性 。 其 中 第 一 个 特性 让 我 在 编 写本 章 初稿 时 感 党 十 分 不 快 : 缺少 条 件 运 
算 符 ?: 的 支持 。 





13.2.3 条件 运 算 符 ?: 和 ref 值 〈C# 7.2 ) 


条 件 运算 符 ?: 从 C# 1.0 开 始 就 出 现 了 ， 其 用 法 和 其 他 语言 中 的 类 似 : 
condition ? expressioni1 : expression2 
该 运算 符 首 先 计算 第 1 个 操作 数 〈 条 件 ) ， 然 后 计算 第 2 个 或 第 3 个 操作 
数 ， 并 将 结果 作为 整个 表达 式 的 最 终结 果 。 该 运算 符 支 持 ref 值 似乎 是 
自然 而 然 的 ， 根 据 条 件 选 择 其 中 一 个 变量 。 
在 C# 7.0 中 条 件 运算 符 并 不 支持 ref， 直 到 C# 7.2 才 开始 支持 。 条 件 运 算 
符 可 以 在 第 2 个 和 第 3 个 操作 数 中 使 用 ref 值 ， 条 件 操作 有 的 结果 整个 也 必 
须 是 使 用 ref 修 饰 的 变量 。 示 例 见 代码 清单 13-9， 其 中 的 
CountEvenAndodd 方 法 会 计算 某 个 序列 中 奇数 和 偶数 的 个 数 ， 然 后 以 元 组 
形式 返回 结果 。 

代码 清单 13-9 ”计算 序列 中 奇数 和 偶数 的 个 数 


static (int even, int odd) CountEvenAndOdd(IEnumerable<int> Value 























var result = (even: 0, odd: 0); 
foreach (var value in values) 


ref int counter = ref (value & 1) == 0 ? (本 行 及 以 下 1 行 ) 选 : 
ref result.even : ref result.odd; 
countert++; <------ 自 增 操作 





return result,; 


} 


这 里 采用 元 组 作为 返回 值 实 属 偶然 ， 不 过 展示 了 可 变 元 组 的 好 处 。 这 一 
修正 让 C# 语 言 的 逻辑 更 统一 了 。 条 件 运算 符 的 结果 可 以 用 作 ref 实 参 ， 
可 以 赋值 给 ref 局 部 变量 ， 也 可 以 用 于 ref retum。 上 所 有 衔接 都 很 顺畅 。 
接 下 来 介绍 C# 7.2 的 新 特性 ， 它 们 解决 了 13.2.1 节 关于 ref 局 部 变量 的 一 
个 限制 问题 ， 如 何 获取 一 个 只 读 变 量 的 引用 ? 








13.2.4 ref readonly (C#7.2) 














前 面 提 到 的 可 以 取 别 名 的 变量 都 是 可 写 变 量 。 在 C#7.0 中 ， 仪 此 一 种 可 
能 ;但 是 在 以 下 两 个 独立 的 场景 中 ， 只 允许 ref 可 写 变 量 就 显得 有 些 捉 
洪 见 肘 了 。 











。 可 能 需要 给 茶 个 只 读 字段 取 别 名 ， 避 免 复制 以 提升 效率 。 
。 可 能 需要 只 允许 通过 ref 变 量 进行 只 读 访问 。 


C# 7.2 引 入 ref readonly 解 决 了 上 述 需 求 。ref 局 部 变量 和 ref return 都 可 
以 使 用 readonly 进 行 修饰 ， 得 到 的 结果 自然 是 只 读 的 ， 就 像 只 读 字段 一 
样 。 不 能 为 只 读 变 量 赋 新 值 ， 如 果 它 是 结构 体 类 型 ， 则 不 能 修改 任何 字 
段 或 者 调用 属性 的 setter 方 法 。 


提示 ”虽然 使 用 ref readonly 可 以 避免 复制 ， 但 有 时 该 特性 会 起 到 
反作用 ，13.4 市 会 探讨 。 在 此 之 前 ， 请 勿 在 产品 代码 中 使 用 ref 


readonly。 


使 用 该 修饰 符 的 两 处 需要 协作 : 如 果 调 用 一 个 带 有 ref readonly 返 回 的 
方法 或 者 索引 器 ， 并 且 需 要 将 结果 保存 到 一 个 局 部 变量 中 ， 那 么 这 个 局 
部 变量 必须 由 ref readonly 修 饰 。 代 码 清 单 13-10 展 示 了 这 两 者 如 何 配 合 
使 用 。 


代码 清单 13-10 ”ref readonly retum 和 和 ref readonly 局 部 变量 











static readonly int field = DateTime.UtcNow.Second; <------ 使 用 一 





static ref readonly int GetFieldAlias() => ref field; <------ 返回 


static void Main() 





ref readonly int local = ref GetFieldAlias(); <------ 调用 方法 : 
Console.writeLine(local); 


} 
这 种 方式 也 适用 于 索引 器 。 这 种 方式 可 以 让 不 可 变 集合 直接 对 外 雄 露 其 
数据 ， 而 无 须 复 制 ， 也 不 存在 内 存 被 算 改 的 风险 。 需 要 注意 ， 可 以 使 
用 ref readonly 返 回 的 变量 本 身 并 不 一 定 是 只 读 的 ， 这 样 就 可 以 为 某 个 
数组 提供 只 读 视 图 了 。 这 一 点 很 像 Readonlycollection， 但 前 者 在 读 取 
时 无 须 复 制 。 代 码 清 单 13-11 是 该 思路 的 一 个 简单 实现 。 

代码 清单 13-11 一 个 数组 的 只 读 视 图 ， 该 数组 允许 自由 复制 


class ReadOonlyArrayView<T> 

















private readonly T[] values; 


} 








public ReadonlyArrayView(T[] values) => (本 行 及 以 下 1 行 ) 复制 数组 ; 


this.values = values; 





public ref readonly T this[int index] => (本 行 及 以 下 1 行 ) 返回 数 丝 


ref values[index]; 


static void Main() 


} 


var array = new int[] { 10, 20, 30 }; 
var View = new ReadOnlyArrayView<int>(array); 


ref readonly int element = ref view[0]; 





Console.WriteLine(element); (本 行 及 以 下 2 行 ) 数组 元 素 的 修改 对 局 部 变 


array[0] = 100; 
Console.writeLine(element); 








这 个 例子 在 性 能 提升 上 表现 平平 ， 因 为 int 类 型 本 映 属于 轻 量 级 ， 但 是 


如 琳 处 理 的 是 大 型 结构 体 ， 采 用 这 种 方式 就 可 以 避免 额外 的 堆 内 存 分 配 


和 垃圾 回收 ， 从 而 显著 提升 性 能 。 


实现 细 市 


在 开 代 码 中 ，ref readon1ly 方 法 是 以 普通 ref 返 回 的 方法 实现 的 〈 返 
回 类 型 是 ref 类 型 ) ， 但 是 应 用 了 system.Runtime.InteropServices 
中 的 TInAttribute] 特 性 。 访 attribute 由 下 中 的 modreq 修 饰 ， 如 果 编 
译 器 不 能 识别 InAttribute， 那 么 它 应 当 拒 绝 任何 对 该 方法 的 调 
用 。 设 想 C# 7.0 编 译 嚣 (能够 识别 ref return， 但 不 能 识别 ref 
readonly return ) 试图 从 另 一 个 程序 集中 调用 一 个 ref readonly 
retumm 的 方法 ， 那 么 它 可 能 会 允许 该 方法 的 返回 值 存储 在 一 个 可 与 
的 ref 局 部 变量 中 ， 之 后 修改 这 个 值 ， 这 样 就 违背 了 ref readonly 
return 的 设计 意图 。 


除非 编译 器 可 以 识别 InAttribute， 否则 无 法 声明 ref readonly 
return 的 方法 。 该 限制 很 少 会 成 为 制约 因素 ， 因 为 从 .NET 1.1 

和 .NET Standard 1.1 开 始 ， 桌 面 famework 中 就 包含 该 特性 了 。 假 如 
该 attribute 不 可 用 ， 那 么 可 以 在 合适 的 命名 空间 中 目 行 声明 该 
attribute， 这 样 编 译 器 就 可 以 正常 应 用 它 了 。 








如 前 所 述 ，readonly 修 饰 符 既 可 以 用 于 局 部 变量 ， 也 可 以 用 于 返回 值 ， 


长 


上 





那么 可 以 用 于 参数 吗 ? 如 果 有 一 个 ref readonly 局 部 变量 ， 需 要 传递 给 
一 个 方法 ， 同 时 不 希望 发 生 数 据 复制 ， 有 什么 方法 吗 ? 读者 可 能 会 认为 
参数 也 需要 使 用 readonly 修 饰 符 ， 但 实际 略 有 不 同 ， 稍 后 探讨 。 


13.3 in 参数 (C# 7.2 ) 


C# 7.2 为 方法 参数 引入 了 新 修饰 符 in。 该 修饰 符 的 使 用 方式 与 ref、out 
相同 ， 但 目的 不 同 。 一 个 带 有 in 修饰 符 的 参数 ， 可 以 通过 引用 传递 从 而 
避免 复制 ， 同 时 可 以 保证 参数 值 不 被 修改 。 在 方法 内 部 ，in 参 数 的 行为 
类 似 于 ref readonly 局 部 变量 。 该 变量 依然 是 由 调用 方 传 入 的 一 个 内 存 
地 址 ， 因 此 要 保证 方法 不 会 修改 该 值 ， 否 则 修改 结果 会 影响 调用 方 ， 这 
样 就 违背 了 in 参数 的 意义 。 


in 参数 与 ref 和 out 参 数 之 间 存 在 一 个 巨大 的 差异 : 调用 方 无 顷 为 调用 实 
参 添 加 in 修饰 符 。 如 果 调 用 时 没有 指定 in 修饰 符 ， 而 实 参 是 某 个 变量 ， 
那么 编译 器 将 按 引 用 传递 该 实 参 ， 但 是 还 要 创建 一 个 隐藏 的 局 部 变量 ， 
并 将 参数 值 赋 给 该 变量 。 如 果 调 用 方 显 式 指定 了 in 修饰 符 ， 那 么 只 有 实 
i 代码 清单 13-12 列 出 了 所 有 可 能 
J 情况 。 


代码 清单 13-12 in 参数 的 合法 传递 实 参 与 非法 传递 实 参 


static void PrintDateTime(in DateTime value) <------ 使 用 in 参 数 声 明 


{ 























string text = value.ToString( 
"yyyy-MM-dd'T'HH:mm:ss", 
CultureInfo.InvariantCulture); 

Console.writeLine(text); 


























} 

static void Main() 

{ 
DateTime start = DateTime.UtcNow; 
printDateTime(start); <------ 变量 隐 式 地 通过 引用 传递 
PrintDateTime(in start); <------ 变量 显 式 地 通过 引用 传递 (由 于 in 修 包 
PrintDateTime(start.AddMinutes(1)); <------ 复制 结果 给 隐藏 的 局 部 ; 
PrintDateTime(in start.AddMinutes(1)); <------ 编译 错误 : 实 参 不 外 

} 


在 生成 的 下 代码 中 ， 形 参 等 同 于 使 用 [IsReadon1yAttribute] 修 饰 的 ref 


参数 。 位 于 System.Runtime.Compilerservices 命 名 空间 下 的 
[IsReadonlyAttribute] 比 InAttribute 引 入 得 晚 ， 存 在 于 .NET 4.7.1 中 ， 
但 .NET Standard 2.0 中 不 存在 。 如 果 要 为 此 而 添加 依赖 或 者 自行 声明 该 
attribute， 束 会 比较 烦琐 。 因 此 ， 如 果 没 有 其 他 attribute 可 用 ， 编 译 器 会 
自动 在 程序 集中 生成 该 attribute。 


该 attribute 在 十 中 没有 modreq 修 饰 符 。 任 何不 能 解析 
IsReadonlyAttribute 的 编译 右 都 将 它 视 为 常规 ref 参 数 (CLR 也 不 需要 
知道 该 attribute) 。 更 高 版 本 的 编译 器 编译 出 来 的 调用 代码 会 突然 编译 
失败 ， 因 为 它们 现在 要 求 in 修 饰 符 而 不 是 ref 修 饰 符 了 ， 这 就 引出 了 一 
个 更 为 庞大 的 关于 同 后 兼容 的 问题 。 


13.3.1 兼容 性 考量 


in 修 饰 符 被 设计 成 调用 时 可 选 ， 这 造成 了 一 个 有 趣 的 回 后 羔 容 问题 。 将 
一 个 方法 形 参 从 值 参数 〈 黑 认 的 不 带 修饰 符 的 参数 ) 修改 为 in 参数 ， 这 
样 的 改动 总 属于 源码 兼容 〈 无 须 修 改 调 用 代码 便 可 以 通过 编译 ) ， 但 不 
属于 二 进 制 兼容 (任何 已 编译 完成 的 程序 集 调用 该 方法 时 会 在 执行 期 失 
败 ) 。 有 共 体 含义 视 具 体 使 用 场景 而 定 。 假 设 现在 要 将 一 个 已 经 及 布 的 程 
序 集中 的 方法 形 参 改 为 in 参数 。 


。 如 果 友 生 改 动 的 方法 在 调用 时 在 我 们 的 控制 范围 之 外 例如 通过 
NuGet 发 布 的 库 ) ， 这 残 属于 破坏 性 改动 ， 应 该 按照 一 般 破 坏 性 改 
动 的 应 对 方式 对 竺 。 

。 如 果 调 用 方 在 调用 方法 前 可 以 重新 编译 代码 〈( 即 便 不 能 改动 调用 代 
码 ) ， 对 于 调用 方 来 说 也 不 是 破坏 性 改动 。 

。 如 采 该 方法 只 用 于 程序 集 内 部 1， 则 无 须 关 心 二 进 制 兼容 问题 ， 
为 所 有 调用 代码 都 将 重新 编译 。 


1 如 果 程 序 集 使 用 了 InternalsVisibleTo， 那么 情况 有 所 不 同 ， 这 些 细节 
差异 超出 了 本 书 的 讨论 范畴 。 


还 有 一 种 比较 少见 的 情况 : 对 于 一 个 带 有 ref 参 数 〈 只 为 避免 复制 ) 的 
方法 (不 在 方法 中 修改 参数 值 )， 将 ref 改 成 in 总 是 二 进 制 兼容 的 ， 但 
源码 不 兼容 。 这 一 点 和 把 值 参数 改 成 in 参数 刚好 相反 。 


以 上 内 容 都 有 一 个 共同 的 前 提 : 使 用 in 参数 不 破坏 方法 本 身 的 语义 ， 但 
这 个 前 提 并 不 总 是 成 立 的 ， 原 因 如 下 。 
































13.3.2 in 参数 惊人 的 不 可 变性 : 外 部 修改 


到 目前 为 止 ， 各 种 迹象 似乎 表明 ， 只 要 不 在 方法 中 修改 参数 ， 就 可 以 安 
全 地 把 它 设 为 In 参数。 然而 事实 并 非 如 此 ， 这 种 想法 不 可 取 。 编 译 占 会 
防止 方法 内 部 修改 参数 值 ， 但 无 法 阻止 其 他 代码 修改 。 必 须 记 住 ，in 参 
0 6 3 


代码 清单 13-13 in 参数 和 值 参 数 在 副作用 上 的 差异 
static void InParameter(in int p, Action action) 


Console.writeLine("Start of InParameter method"); 
Console.WriteLine($"p = {p}"); 
action( ); 
Console.WriteLine($"p = {p}"); 
} 


static void ValueParameter(int p, Action action) 


Console.writeLine("Start of ValueParameter method"); 
Console.WriteLine($"p = {p}"); 

action( ); 

Console.WriteLine($"p = {p}"); 


} 
static void Main() 


int x = 10; 
InParameter(x, () => x++); 


int y = 10; 
ValueParameter(y, () => y++); 


} 


前 两 个 方法 除了 参数 属性 和 打印 信息 不 同 ， 其 他 内 容 都 相同 。 在 Main 方 
法 中 ， 调 用 两 个 方法 的 方式 也 相同 ， 把 一 个 初始 值 为 10 的 变量 作为 实 参 
进行 传递 ， 然 后 由 action 来 为 该 变量 执行 自 增 操作 。 下 面 的 执行 结果 展 
示 了 两 个 方法 在 语义 上 的 差别 : 


Start of InParameter method 
p= 10 

p = 11 

Start of ValueParameter method 





10 
10 


p 二 
p pe 
可 见 InParameter 方 法 能 够 体现 出 参数 由 于 action( ) 调 用 而 发 生 的 变化 ， 
而 ValueParameter 不 能 。 这 并 不 意外 ， 因 为 in 参 数 的 目的 就 是 共享 同一 
个 内 存 位 置 ， 而 值 参数 只 是 执行 一 次 值 复 制 。 


问题 在 于 ， 在 这 个 特定 的 简单 例子 中 ， 问 题 显而易见 ， 但 实际 情况 并 不 
总 是 如 此 。 假 如 in 参数 刚好 是 同一 个 类 型 中 茶 个 字段 的 别名 ， 这 时 对 该 
字段 的 任何 修改 ， 无 论 是 直接 在 方法 中 修改 ， 还 是 由 方法 调用 的 其 他 代 
码 来 修改 ， 都 会 反映 到 参数 中 ， 那 么 对 于 调用 代码 或 方法 本 号 ， 都 不 是 
显而易见 的 。 如 果 牵 涉 多 线程 ， 就 更 难 预测 代码 行为 了 。 


虽然 有 些 “ 危 言 等 听 ”， 但 意 在 强调 这 是 一 个 很 实际 的 问题 。 我 们 已 经 习 
惯 了 使 用 ref 修 饰 形 参 和 实 参 来 强调 此 类 行为 的 可 能 2。 此 外 ，ref 修 饰 
和 从 给 人 的 感觉 是 ， 使 用 它 就 要 关注 参数 的 变化 是 人 否 可 见 ，in 修 饰 符 则 强 
调 参数 的 不 可 变性 。13.3.4 节 还 会 给 出 关于 in 参数 的 使 用 指导 ， 目 前 只 
需要 知道 in 参数 可 能 会 发 生意 外 的 更 改 即 可 。 


2 我 喜欢 把 它 看 作 * 远 距离 怪异 的 ”量子 纠缠 现象 。 
13.3.3 ”使 用 in 参数 进行 方法 重 载 


至 此 ， 还 有 一 个 问题 未 讨论 ， 如 果 有 两 个 方法 同名 且 参数 类 型 相同 ， 其 
中 一 个 的 参数 使 用 了 in 修 饰 符 ， 而 另 一 个 没有 ， 会 发 生 什么 ? 


请 记 住 ，CLR 只 知道 这 是 一 个 ref 参 数 。 因 此 无 法 通过 只 改变 ref、out 
以 及 in 修 饰 符 来 重 载 方法 。 对 于 CLR 来 说 它们 是 相同 的 ， 但 我 们 可 以 通 
过 添加 in 修饰 符 来 重 载 一 个 普通 值 参 数 的 方法 : 


void Method(int x) { ... } 
void Method(in int x) { ... } 


在 进行 章 载 决议 时 ， 带 有 值 参 数 的 方法 比 不 带 有 in 参 数 的 方法 优先 级 


[Sj]: 





























int x = 5; 





Method(5); <------ 调用 第 1 个 方法 
Method(x); <------ 调用 第 1 个 方法 

















于 in 修 饰 符 的 存在 ， 会 调用 第 2 个 方法 





Method(in x); <------ 


全 











有 了 这 些 规 则 ， 为 现 有 值 参 数 的 方法 添加 in 参数 的 重 载 方法 时 ， 不 用 太 
过 担心 兼容 性 问题 。 


13.3.4 ” in 参数 的 使 用 指导 


a 我 还 不 曾 在 实际 代码 中 使 用 过 in 参数 ， 以 下 指导 意见 都 是 基于 推 
测 的 。 


需要 注意 的 第 一 点 是 : in 参 数 的 设计 初 囊 是 提升 效率 。 一 条 普遍 性 原则 
是 ， 在 对 代码 做 有 效 、 反 复 的 性 能 评估 ， 并 且 设 定好 性 能 目标 之 前 ， 不 
要 为 了 提升 性 能 而 贸然 更 改 代码 。 如 果 更 改 不 够 慎重 ， 就 会 以 提升 性 能 
之 名 把 代码 复杂 化 ， 结 果 发 现 即便 某 几 个 方法 的 性 能 大 幅 提 升 了 ， 这 几 
个 方法 却 不 在 应 用 的 关键 路 径 上 。 有 具体 的 性 能 目标 和 正在 编写 代码 的 类 
型 相关 (游戏 、Web 应 用 、 库 、 物 联网 应 用 等 ) ， 并 且 需 要 慎之 又 慎 。 
我 推荐 将 BenchmarkDorNet 项 目 作 为 小 型 性 能 评测 工具 。 


in 参数 的 优势 在 于 能 有 效 避 免 数 据 复制 。 如 果 只 是 使 用 引用 类 型 或 者 小 
型 结构 体 ， 可 能 根本 不 会 有 什么 性 能 提升 。 从 过 辑 上 讲 ， 哪 但 内 存 地 址 
中 的 值 不 发 生 复制 ， 内 存 地 址 本 身 也 需要 传递 给 方法 。 因 为 JIT 编 译 和 
优化 机 制 对 于 我 们 来 说 是 个 黑 盒 ， 所 以 这 里 不 做 深究 。 不 经 测试 的 性 能 
提升 都 是 空谈 ， 因 为 性 能 问题 牵扯 的 因素 太 多 了 ， 任 何 推理 都 可 能 只 是 
有 限 的 理性 推测 。 不 过 随 独 结构 体 规模 的 不 断 增 大 ， 使 用 in 参数 的 优势 
也 会 逐渐 提升 。 


我 对 于 ;in 参数 的 主要 担心 是 ， 它 会 使 代码 变 得 难以 理解 。 如 13.3.2 节 所 
述 ， 即 便 方 法 中 并 没有 修改 参数 的 值 ， 但 是 两 次 对 同一 个 参数 值 的 读 取 
得 到 了 不 同 的 结果 。 这 样 不 仅 不 利于 正确 编写 代码 ， 而 且 可 能 会 编写 出 
似是而非 的 代码 。 

不 过 ， 有 一 种 方式 可 以 做 到 既 利 用 in 参数 的 优势 ， 又 能 够 避免 上 述 问 

题 : 减少 或 者 移 除 任何 可 能 修改 参数 值 的 代码 。 假 设 有 一 个 公共 APL， 

该 API 通 过 一 系列 深层 僚 套 的 私有 方法 调用 实现 ， 那 么 对 于 该 API 本 身 

应 当 使 用 值 参数 ， 而 对 那些 私有 方法 使 用 in 参数 。 代 码 清单 13-14 虽 然 
实际 价值 不 大 ， 却 是 一 个 很 好 的 示例 。 

代码 清单 13-14 ”安全 地 使 用 in 参数 


public static double PublicMethod( (本 行 及 以 下 2 行 ) 使 用 值 参数 的 公共 方 涪 


























LargeStruct first， 
LargeStruct Second ) 


{ 
double firstResult = PrivateMethod(in first); 
double secondResult = PrivateMethod(in second); 
return firstResult + secondResult,; 

} 


private static double PrivateMethod( (本 行 及 以 下 1 行 ) 使 用 in 参数 的 私有 : 
in LargeStruct input) 





double scale = GetScale(in input); 
return (input.X + input.Y + input.Z) * scale; 


private static double GetScale(in LargeStruct input) => <------ 于 
input.weight * input.Score; 


采用 这 种 方式 可 以 防止 参数 被 意外 修改 ， 因 为 所 有 方法 都 是 私有 的 ， 我 
们 可 以 检查 所 有 调用 方 ， 确 定 它们 不 会 传递 那些 在 方法 执行 时 可 能 被 修 
改 的 参数 。 在 PublicMethod 方 法 调用 时 ， 每 个 结构 体 只 会 被 复制 一 次 ， 
但 这 些 复 制品 之 后 在 私有 方法 调用 时 都 是 别名 。 这 样 就 把 自己 的 代码 和 
其 他 线程 中 调用 方 的 任何 修改 ， 或 者 其 他 方法 的 副作用 隔离 开 来 了 。 有 
时 可 能 需要 允许 修改 参数 ， 但 是 需要 写 好 文档 并 且 诬 慎 控 制 。 


也 可 以 把 相同 的 迎 辑 应 用 于 内 部 调用 ， 但 是 需要 更 多 限制 ， 因 为 会 有 更 
多 代码 能 够 调用 当前 方法 。 我 个 人 习惯 在 调用 时 和 方法 声明 时 ， 都 给 参 
数 加 上 in 修 饰 符 ， 这 样 在 阅读 代码 时 能 准确 理解 代码 意图 。 


上 述 内 容 可 总 结 为 以 下 建议 。 


人 

时 。 

。 在 公共 API 中 尽量 避免 使 用 in 参数 ， 除 非 即 便 参 数值 发 生变 化 ， 方 
法 也 能 正确 执行 。 

。 可 以 考虑 通过 公共 方法 作为 防止 参数 被 修改 的 外 部 屏障 ， 然 后 在 内 
部 私有 方法 中 使 用 in 参数 来 减少 复制 。 

。 对 于 采用 in 参数 的 方法 ， 在 调用 时 考虑 显 式 给 出 in 修饰 符 《〈 除 非 有 
意 利 用 纺 译 需 来 通过 引用 传递 隐藏 的 局 部 变量 ) 。 


使 用 Roslyn 分 析 吉 应 该 很 容易 检查 这 些 指 导 性 策略 。 目 前 还 没有 这 样 一 




















亚 分 析 器 ， 但 将 来 很 有 可 能 出 现在 NuGet 包 管理 器 中 。 


说 明 如果 读者 及 现 这 样 一 球 分 析 器 ， 请 告知 我 ， 我 会 在 本 书 的 网 
De 


以 上 所 说 的 性 能 提升 都 需要 考量 减少 的 复制 量 ， 这 听 起 来 并 不 很 下 日 。 
下 面 详细 介绍 编译 器 会 在 何 时 静默 完成 复制 工作 ， 以 及 如 何 避 免 复制 。 


13.4 ”将 结构 体 声明 为 只 读 〈C# 7.2) 


in 参数 的 主要 作用 是 减少 对 结构 体 的 复制 从 而 提升 性 能 。 听 起 来 很 不 
错 ， 但 是 关于 C#， 还 有 一 个 隐蔽 的 阻碍 ， 需 要 格外 小 心 。 本 布 首 先 明确 
问题 ， 然 后 介绍 C# 7.2 是 如 何 解决 它 的 。 


13.4.1 背景 : 只 读 变 量 的 隐 式 复制 


长 期 以 来 ，C# 都 对 结构 体 进行 隐 式 复制 。 虽 然 语言 规范 中 写 明 了 这 一 
扩 ， 但 如 果 不 古 在 Noda Time 项 目 中环 记 给 一 个 字段 添加 只 读 属 性 而 导 
致 性 能 卉 凋 提 升 ， 我 大 概 完全 不 会 注意 到 这 一 点 。 


看 一 个 简单 的 例子 。 首 先 声 明 一 个 有 3 个 只 读 属 性 的 结构 

体 YearMonthDay，3 个 属性 分 别 为 Year、Month 和 Day。 这 里 不 采用 内 建 的 
DateTime 类 型 ， 到 后 面 自然 就 知道 原因 了 。 代 码 清 单 13-15 是 关于 
YearMonthDay 的 ， 相当 简单 。 (这 段 代 码 仅 用 作 展 示 ， 因此 并 没有 任何 
校 验 逻辑 。) 


代码 清单 13-15 一 个 简单 的 year/month/day 结 构 体 


public struct YearMonthDay 
{ 








public int Year { get; } 
public int Month { get } 
public int Day { get,; } 


public YearMonthDay(int year, int month, int day) => 


(Year, Month, Day) = (year, month, day); 
} 


然后 创建 一 个 包含 两 个 YearMonthDay 字 段 的 类 : 一 个 只 读 ， 男 一 个 可 读 


写 。 之 后 会 访问 这 两 个 字段 的 Year 属 性 。 
代码 清单 13-16 ”通过 只 读 或 读 写字 段 访问 属性 
class ImplicitFieldCopy 


private readonly YearMonthDay readonlyField = 
new YearMonthDay(2018, 3, 1); 

private YearMonthDay readwriteField = 
new YearMonthDay(2018, 3, 1); 


public void CheckYear() 


{ 
int readOonlyFieldYear = readOonlyField.Year; 


int readwriteFieldYear = readwriteFieJd.Year ， 
} 


这 两 个 属性 访问 操作 所 生成 的 和 工 代码 虽然 只 是 略 有 差别 ， 但 意义 重大 。 
下 面 是 只 读 字 段 的 蕊 代码， 简单 起 见 ， 略 去 了 相应 的 命名 空间 : 


ldfld valuetype YearMonthDay ImplLicitFieldcopy': :readonlyField 
stloc.0 

ldloca.s V_0 

call instance int32 YearMonthDay: :get_Year() 


这 上段 代码 首先 载 入 字段 的 值 ， 然 后 将 其 复制 到 栈 内 存 中 ， 之 后 才 调 用 了 
get_Year() 成 员 ， 这 个 正 是 Year 属 性 的 getter 方 法 。 与 之 相对 的 读 写 字段 
的 卫 代 码 如 下 : 


ldflda valuetype YearMonthDay ImplicitFieldCopy::readwriteField 
call instance int32 YearMonthDay: :get_Year() 


其 中 使 用 了 1dflda 指 令 来 将 字段 的 地 址 加 载 到 栈 内 存 ， 而 1df1d 指 令 是 
把 值 加 载 到 栈 内 存 中 。 当 然 ， 这 只 是 下 代码 ， 还 不 是 计算 机 最 终 执 行 的 
指令 。 有 时 JITI 编 译 器 可 以 优化 这 部 分 ， 但 是 就 Noda Time 项 目 来 说 ， 当 
把 字段 声明 为 读 写 属 性 时 〈 通 过 一 个 attribute 来 解释 为 什么 不 是 只 

读 ) ， 性 能 提升 显著 。 


编译 器 之 所 以 复制 字段 ， 就 是 为 了 防止 只 读 和 字段 在 属性 《或 者 方法 ) 中 
被 修改 。 只 读 字 有 段 的 本 意 就 是 禁止 修改 其 值 。 如 果 
readonlyField.SomeMethod( ) 可 以 修改 该 字段 就 不 正常 了 。 按 照 C# 的 语 











言 设计 ， 任 何 属性 setter 都 会 修改 数据 ， 因 此 蔡 止 setter 访 问 器 操作 只 读 
字段 。 可 即便 是 getter 访 问 髓 ， 也 可 能 会 修改 字段 值 ， 所 以 为 字段 备份 
是 安全 之 举 。 

隐 式 复制 只 影响 值 类 型 

需要 注意 : 对 于 只 读 字 段 ， 如 果 它 是 引用 类 型 ， 那 么 在 方法 内 可 以 
修改 该 引用 类 型 所 指 问 的 对 象 。 例 如 有 一 个 只 读 的 StringBuilder 
字段 ， 对 该 stringBuilder 依 然 可 以 执行 append 操 作 。 该 字段 的 值 是 
引用 ， 只 要 引用 本 映 不 被 改变 即 可 。 

这 部 分 着 重 讨 论 类 似 于 decimal 或 者 DateTime 这 样 的 值 类 型 ， 至 于 字 
段 属于 类 还 是 结构 体 ， 无 关 紧 要 。 
在 C# 7.2 之 前 ， 只 有 字段 可 以 设 为 只 读 ， 现 在 又 增加 了 ref readonly 局 
i 0 
月 日 信息 。 


private void PrintYearMonthDay(YearMonthDay input) => 
Console.writeLine($"{input.Year} {input.Month} {input.Day}"); 


J 的 世代 码 使 用 了 栈 内 存 中 已 有 的 地 址 。 每 个 属性 访问 都 很 简 











ldarga.s Input 
call instance int32 Chapter13 .YearMonthDay': :get_Year() 


它 不 创建 任何 额外 的 复制 。 它 假定 如 宁 属 性 修改 了 值 ， 那 么 input 变 量 
的 值 也 可 以 修改 ， 因 为 它 是 一 个 读 写 属性 的 变量 。 但 是 如 果 给 参数 添 
加 in 修饰 符 ， 情 况 融 不 同 了 : 


private void PrintYearMonthDay(in YearMonthDay input) => 
Console.writeLine($"{input.Year} {input.Month} {input.Day}"); 


这 样 工 代码 中 的 每 个 属性 访问 就 变 成 了 : 


ldarg.1 

ldobj Chapter13 .YearMonthDay 

stloc.0 

ldloca.s V_0 

call instance int32 YearMonthDay: :get_Year() 





ldobj 指 令 从 参数 地 址 中 把 值 复 制 到 了 栈 内 存 中 。 我 们 本 想 使 用 in 参数 
来 避免 调用 方 的 第 一 次 复制 操作 ， 结 果 方 法 内 部 增加 了 3 次 复制 操作 ， 
对 于 ref readonly 局 部 变量 也 是 一 样 ， 事 与 愿 违 。 读 者 可 能 已 经 猜 到 
了 ，C# 7.2 给 出 了 一 个 解决 方案 : 使 用 只 读 结构 体 。 


13.4.2 ”结构 体 的 只 读 修 饰 符 

回顾 一 下 前 面 的 重点 ，C# 编 译 占 之 所 以 要 复制 只 读 值 类 型 的 变量 ， 是 为 
了 防止 代码 算 改 该 变量 的 值 。 如 末 结 构 体 可 以 保证 变量 的 值 不 会 被 修改 
会 怎么 样 呢 ? 毕竟 大 部 分 结构 体 是 不 可 变 结构 体 。 在 C# 7.2 中 ， 可 以 在 
声明 结构 体 时 添加 readonly 修 饰 符 来 实现 这 一 目标 。 


下 面 使 用 readonly 结 构 体 来 改写 前 面 年 月 日 的 代码 。 这 段 代 码 已 经 满足 
了 相关 语义 要 求 ， 只 需 直 接 添 加 readonly 修 饰 符 即 可 : 


public readonly struct YearMonthDay 
{ 




















public int Year { get; } 
public int Month { get } 
public int Day { get; } 


public YearMonthDay(int year, int month, int day) => 
(Year, Month, Day) = (year, month, day); 
} 


无 须 修 改 使 用 结构 体 的 代码 ， 只 需 在 声明 结构 体 时 做 一 点 小 小 的 改 
动 ，PrintYearMonthDay(in YearMonthDay input) 生 成 的 下 代码 就 变 得 高 
效 了 。 每 个 属性 访问 的 代码 如 下 : 


ldarg.1 
call instance int32 YearMonthDay: :get_Year() 


终于 实现 了 不 复制 整个 结构 体 这 一 目标 。 


在 本 书 附 读 的 源码 中 ， 这 段 代 码 位 于 一 个 单独 的 结构 体 声 

明 ReadonlyYearMonthDay 中 。 源码 之 所 以 把 只 读 结构 体 的 声明 单独 拿 出 
来 ， 旨 在 对 比 前 后 两 个 声明 。 读 者 编写 代码 时 可 以 直接 在 现 有 结构 体 中 
添加 readonly， 这 样 做 不 会 造成 任何 源码 和 二 进 制 码 的 兼容 问题 。 如 果 
反 过 来 ， 束 可 能 是 破坏 性 修改 : 比如 移 除 现 有 的 readonly 修 饰 符 并 修改 
现 有 的 某 个 成 员 值 ， 那 么 之 前 编译 的 代码 〈 把 结构 体 按 照 只 读 处 理 ) 将 











修改 只 读 变 量 ， 这 可 糟 了 。 


只 有 当 目 标 结构 体 本 吴 是 只 读 的 时 ， 才 能 为 其 添加 readonly 修 饰 符 ， 
此 必须 满足 以 下 条 件 。 


。 每 个 实例 字段 和 目 动 实现 的 实例 属性 必须 是 只 读 的 。 静 态 字段 和 属 
性 可 以 不 做 要 求 。 

。 只 能 在 构造 器 中 为 this 赋值 。 用 语言 规范 中 的 术语 来 说 : this 在 构 
造 希 中 按照 out 参 数 来 处 理 ， 在 普通 结构 体 成 员 中 按照 ref 参 数 来 处 
理 ， 在 只 读 结 构 体 成 员 中 按照 in 参数 来 处 理 。 

如 果 当 前 结构 体 想 按照 只 读 处 理 ， 那 么 为 它 添 加 readonly 修 饰 符 就 可 以 
让 编译 需 帮 忙 检 查 是 人 否 存在 修改 结构 体 的 代码 。 用 户 目 定义 的 结构 体 大 
都 可 以 正常 应 用 该 特性 。 不 过 依然 存在 一 个 潜在 问题 ， 该 问题 影响 了 
Noda Time 项 目 ， 也 可 能 影响 读者 的 茶 些 代码 。 


13.4.3 XML 序列 化 是 隐 式 恋 写 属性 
目前 Noda Time 中 的 大 部 分 结构 体 实 现 自 Ixmlserializable 接 口 ， 然 而 


XML 序列 化 的 定义 对 于 编写 只 读 结 构 体 很 不 友好 。Noda Time 中 的 实现 


void IXmlSerializable.ReadXml(XmlReader reader ) 

















{ 
var pattern = /* some suitable text parsing pattern for the t 
Var text = /* extract text from the XmlLReader */; 
this = pattern.Parse(text).Value; 

上 


能 发 现 其 中 的 问题 吗 ? 最 后 一 行 代码 是 把 结果 赋值 给 this， 这 样 就 不 能 
把 结构 体 声明 为 readonly 了 ， 实 为 困扰 。 目 前 对 此 只 有 3 个 选择 。 


。 放任 不 管 ， 但 这 样 的 话 in 参 数 和 ref readonly 局 部 变量 的 效率 会 降 
低 : 

。 在 Noda Time 的 下 一 个 主 版 本 中 移 除 XML 序 列 化 。 

。 在 Readxml 中 使 用 非 安 全 的 代码 破坏 readonly 规 则 。 使 
用 System.Runtime .compilerservices 包 可 以 简化 这 一 过 程 。 


以 上 选项 都 不 太 完 美 ， 也 没有 什么 办 法 可 以 同时 解决 上 述 3 个 问题 。 目 


前 我 选择 接受 实现 TXxmlserializable 接 口 的 结构 体 天 生 不 能 使 用 只 读 属 
性 。 当 然 ， 在 实现 结构 体 时 还 可 能 遇 到 其 他 接口 ， 也 像 
IXmlSerializable 一 样 不 支持 只 读 ， 但 Ixmlserializable 肯 定 更 常见 。 


好 在 大 部 分 读者 不 会 遇 到 这 个 问题 。 我 认为 只 要 可 以 把 结构 体 声明 为 只 
读 ， 就 尽量 这 么 做 。 但 请 记 住 ， 这 项 改动 不 可 道 。 只 有 在 能 够 保证 将 来 
即使 移 除 readonly 修 饰 符 也 能 重新 编译 调用 代码 的 情况 下 ， 才 可 以 为 现 
有 结构 体 添 加 readonly 修 饰 符 。 下 面 要 介绍 的 特性 为 C# 语 言 的 一 致 性 添 
上 了 最 后 一 块 砖 : 为 结构 体 的 扩展 方法 添加 和 实例 方法 相同 的 功能 。 


13.5 ”使 用 ref 参 数 或 者 in 参数 的 扩展 方法 《CC# 
7.2 ) 


在 C# 7.2 之 前 ， 任 何 扩展 方法 的 第 一 个 参数 都 必须 是 值 参数 。C# 7.2 取 
消 了 这 项 限制 ， 于 是 ref 相 关 语 义 应 用 得 更 彻 后 了 。 


13.5.1 在 扩展 方法 中 使 用 ref/in 参 数 来 规避 复制 


假设 有 一 个 大 型 结构 体 ， 我 们 想 避 免 复 制 它 。 另 外 ， 有 一 个 方法 根据 该 
结构 体 的 几 个 属性 值 计 算 一 个 三 维 癌 量 坐 标 。 如 果 该 结构 体 自 带 这 样 的 
方法 (或 者 属性 ) ， 自 然 可 以 规避 复制 过 程 ， 若 是 该 结构 体 声明 为 只 
读 ， 毫 无 疑问 可 以 规避 复制 。 若 想 实现 结构 体 作 者 未 曾 考虑 过 的 复杂 操 
作 ， 该 怎么 办 呢 ? 代码 清单 13-17 提 供 了 一 个 只 读 的 vector3D 结 构 体 ， 该 
结构 体 只 有 3 个 属性 x、Y、z。 


代码 清单 13-17 vector3D 结 构 体 的 小 例子 


public readonly struct Vector3D 























public double Xx { get; } 
public double Y { get; } 
public double ZzZ { get; } 


public Vector3D(double x, double y, double z) 
{ 

Xx; 

yr’ 


X 
Y 
Z Zz; 


} 


可 以 自己 编写 一 个 接收 in 结构 体 参数 的 方法 ， 这 样 做 虽然 能 够 避免 复 
制 ， 但 调用 时 略 显 奇 怪 ， 最 后 写 出 的 调用 代码 可 能 如 下 所 示 : 


double magnitude = VectorUtilities.Magnitude(vector); 


De 如 有 果 使 用 扩展 方法 ， 则 每 次 调用 时 都 要 复制 该 结构 





public static double Magnitude(this Vector3D vector) 


在 可 读 性 和 性 能 之 间 进 行 取舍 令 人 苗 恼 。C#7.2 提 出 了 一 种 合理 的 改进 
方式 : 编写 扩展 方法 时 ， 第 一 个 参数 前 可 以 添加 ref 或 者 in 修饰 符 。 修 
饰 符 可 以 位 于 this 前 ， 也 可 以 位 于 this 后 。 如 果 只 需要 计算 出 一 个 新 
值 ， 那 么 可 以 使 用 in 修饰 符 ， 如 果 需 要 修改 原始 内 存 位 置 上 的 值 ， 又 不 
想 创 建 并 复制 一 个 新 值 ， 可 以 选用 ref 修 饰 符 。 代 码 清 单 13-18 中 包含 了 
对 于 vector3D 的 两 种 扩展 方法 。 


代码 清单 13-18 ”使 用 ref 和 和 in 修饰 符 的 扩展 方法 


public static double Magnitude(this in Vector3D vec) => 
Math.Sqrt(vec.X * vec.X + Vec.Y * Vec.Y + Vec.Z * Vec.27); 








public static void offsetBy(this ref Vector3D orig, in Vector3D 0 
orig = new Vector3D(orig.X + off.X, orig.Y + off.Y, orig.Z + 


我 通 第 不 会 给 参数 取 这 种 简短 的 名 称 ， 但 古 由 于 书页 排版 的 原因 不 得 不 
将 参数 名 简化 。offsetBy 方 法 的 第 2 个 参数 也 添加 了 in 修饰 符 ， 因 为 我 
们 想 尽 量 避 免 复制 操作 。 


扩展 方法 易于 使 用 。 唯 一 需要 注意 的 是 ， 和 普通 ref 参 数 不 同 ， 在 调用 
扩展 方法 时 不 需要 指定 ref 修 饰 符 。 代 码 清单 13-19 调 用 了 前 面 的 两 个 扩 
展 方法 来 创建 两 个 同 量 ， 使 用 第 2 个 同 量 为 第 1 个 回 量 增加 侦 移 量 ， 然 后 
打印 结果 问 量 及 其 大 小 。 

代码 清单 13-19 调用 ref 参 数 和 in 参数 的 扩展 方法 


Var Vector 
Var offset 





new Vector3D(1.5, 2.0, 3.0); 
new Vector3D(5.0, 2.5, -1.0); 


Vector ,OffsetBy(offset ) ， 


Console.writeLine($"({vector.X}, {vector.Y}, {vector.2})"); 
Console.writeLine(vector.Magnitude( )); 


执行 结果 如 下 : 


(6.5, 4.5, 2) 
8.15475321515004 


调用 offsetBy 方 法 修改 vector 变 量 的 目的 达成 。 


说 明 offsetBy 方 法 似乎 让 不 可 变 的 vector3D 结 构 体 可 变 了 。 该 特 
性 只 是 初出 茅 庐 ， 还 有 许多 地 方 需要 提升 。 就 目前 而 言 ， 我 个 人 更 
愿意 编写 in 参数 的 扩展 方法 。 


带 有 in 参数 的 扩展 方法 ， 可 以 在 读 写 属 性 的 变量 上 调用 《例如 
vector .Magnitude()) ， 而 带 有 ref 参 数 的 扩展 方法 无 法 在 只 读 变 量 上 调 
用 。 如 果 为 vector 创 建 一 个 只 读 别 名 ， 则 无 法 调用 offsetBy 方 法 : 


ref readonly var alias = ref vector; 
alias,OffsetBy(offset); <------ 非法 : 将 只 读 变 量 用 作 ref 变 量 


与 普通 扩展 方法 不 同 ，ref 和 ;in 参数 的 扩展 方法 的 目标 类 型 〈 第 一 个 参 
数 的 类 型 ) 是 存在 限制 的 。 


13.5.2 ref 和 in 扩展 方法 的 使 用 限制 


普通 的 扩展 方法 可 以 针对 任何 类 型 进行 扩展 。 扩 展 方法 使 用 的 类 型 可 以 
是 普通 类 型 ， 也 可 以 是 有 类 型 约束 或 者 无 类 型 约束 的 类 型 形 参 : 


static void Method(this String target) 

static void Method(this IDisposable target) 

static void Method<T>(this T target) 

static void Method<T>(this T target) where T : IComparable<T> 
static void Method<T>(this T target) where T : struct 


而 ref 和 in 扩 展 方法 只 能 扩展 值 类 型 。 在 in 扩 展 方法 中 ， 该 值 类 型 也 不 
能 是 类 型 形 参 。 以 下 声明 合法 : 


static void Method(this ref int target) 
static void Method<T>(this ref T target) where T : struct 




















static void Method<T>(this ref T target) where T : struct, ICompa 
static void Method<T>(this ref int target, T other) 

static void Method(this in int target) 

static void Method(this in Guid target) 

static void Method<T>(this in Guid target, T other) 


而 以 下 声明 非法 : 


static void Method(this ref string target) <------ 引用 类 型 target 用 

static void Method<T>(this ref T target) (本 行 及 以 下 1 行 ) 类 型 形 参 tar 
where T : IComparable<T> 

static void Method<T>(this in string target) <------ 引用 类 型 targetl 

static void Method<T>(this in T target) (本 行 及 以 下 1 行 ) 类 型 形 参 targt 
where T : struct 


要 注意 in 和 ref 的 区 别 : ref 参 数 可 以 是 类 型 形 参 ， 只 要 它 具 备 一 
ee in 扩展 方法 可 以 是 泛 型 的 (参见 合 法 示例 的 最 后 
一 个 ) ， 但 被 扩展 的 类 型 不 能 是 类 型 形 参 。 目 前 还 没有 类 型 约束 能 够 规 
二 Nreadonly struct。 在 将 来 的 C# 版 本 中 这 一 点 可 能 会 发 生变 


扩展 类 型 必须 是 值 类 型 ， 这 主要 有 以 下 两 个 原因 。 


。 该 特性 就 是 用 于 避免 复制 值 所 导致 的 性 能 消耗 的 ， 而 引用 类 型 不 存 
在 这 样 的 性 能 消耗 。 

。 如 果 ref 参 数 是 引用 类 型 ， 那 么 它 可 能 是 nu11 引 用 。 这 样 就 违背 了 
目前 C#JF 发 人 员 和 工具 的 一 条 假定 : x.Method()(x 如 果 古 一 个 引 
用 类 型 变量 ) 的 调用 中 ，x 不 能 为 nu11。 


ref 和 in 扩展 方法 的 应 用 不 会 特别 广泛 ， 但 是 它们 的 出 现 确实 增强 了 C# 
语言 的 内 在 一 致 性 。 


本 章 内 容 概 览 中 提 到 的 特性 和 目前 介绍 的 特性 有 些 出 入 ， 回 顾 如 下 。 
ref 局 部 变量 。 


ref return 。 

ref 局 部 变量 和 ref retum 的 只 读 版 。 

in 参数 : ref 人 参数 的 上 只 读 版 。 

只 读 结 构 体 ， 让 in 参数 以 及 只 读 ref 局 部 变量 和 ref return 可 以 避免 
复制 。 

e。 ref 和 ;in 参数 的 扩展 方法 。 








如 休 从 ref 参 数 出 及， 思考 应 该 如 何 扩展 这 个 概念 ， 束 可 能 得 出 一 个 类 
似 的 特性 清单 。 接 下 来 介绍 类 ref 结 构 体 的 相关 内 容 ， 虽 然 该 特性 和 前 
面 介绍 的 特性 有 一 定 相 关 性 ， 但 像 是 全 新 的 类 型 。 


13.6 ”类 ref 结 构 体 〈C# 7.2 ) 


C# 7.2 引 入 了 类 ref 结 构 体 的 概念 : 只 存在 于 栈 内 存 上 的 结构 体 。 与 自 定 
义 task 类 型 相似 ， 很 可 能 我 们 永远 不 需要 自行 声明 类 ref 结 构 体 ， 但 我 们 
所 使 用 的 framework 中 很 可 能 内 建 类 ref 结 构 体 。 


首先 介绍 类 ref 结 构 体 的 基本 规则 ， 然 后 介绍 其 使 用 方式 以 及 framework 
的 文 持 方式 。 这 里 介绍 的 使 用 规则 都 是 简化 后 的 ， 有 其 体 规 则 参见 语言 规 
范 。 尽 管 很 少 有 开发 人 员 需 要 知道 编译 圳 是 如 何 保证 类 ref 结 构 体 在 栈 
内 存 上 的 安全 的 ， 但 是 应 该 了 解 该 特性 的 主要 实现 目标 : 


类 ref 结 构 体 的 值 必须 永远 保存 在 栈 内 存 中 。 
首先 创建 一 个 类 ref 结 构 体 ， 其 声明 方式 只 比 声明 普通 结构 体 多 了 一 


个 ref 修 饰 符 : 











public ref struct RefLikeStruct 
{ 


ee 和 普通 结构 体 一 样 的 成 员 








} 
13.6.1 类 ref 结 构 体 的 规则 


先 不 介绍 RefLikestruct 的 用 途 ， 而 是 列 出 它 不 能 用 来 做 什么 ， 并 给 出 
相应 解释 。 


。 对 于 任何 不 是 类 ref 结 构 体 的 类 型 ，RefLikestruct 不 能 用 作 其 字 
段 。 即 便 是 普通 的 结构 体 ， 也 可 以 通过 装 箱 或 者 成 为 某 个 类 字段 的 
方式 最 终 存储 在 堆 内 存 中 。 即 使 在 其 他 类 ref 结 构 体 
人 不 能 是 静态 字段 
类 型 。 

。 不 能 对 RefLikestruct 执 行 装 箱 操作 。 装 箱 则 在 在 堆 内 存 中 创建 一 
个 对 象 ， 这 绝对 不 是 我 们 想 要 的 结果 。 











。 不 能 把 RefLikestruct 用 作 类 型 实 参 (不 管 是 显 式 方式 还 是 类 型 推 
断 方 式 ) ， 任 何 泛 型 方法 或 者 类 型 都 不 可 以 ， 也 不 能 用 作 某 个 泛 型 
类 ref 结 构 体 的 类 型 实 参 。 泛 型 代码 可 以 以 多 种 方式 将 泛 型 实 参 存 
放 于 堆 内 存 中 ， 例 如 创建 List<T>。 

。 不 可 以 创建 RefLikestruct[]， 类 似 的 数组 类 型 也 不 能 用 作 typeof 运 
算 符 的 操作 数 。 

。 RefLikestruct 类 型 的 局 部 变量 不 能 用 于 编译 器 可 能 需要 在 某 个 生 
成 类 型 中 进行 堆 内 存 中 捕获 的 情况 ， 包 括 如 下 几 类 。 

o async 方 法 。 这 个 要 求 不 是 那么 严格 ， 例 如 变量 可 以 在 await 表 
达 式 之 间 进 行 声 明和 使 用 (在 await 之 前 声明 ， 在 其 之 后 使 
用 ) 。async 方 法 的 参数 不 能 是 类 ref 结 构 体 类 型 。 

o 迭代 器 块 ， 它 的 规则 大 致 是 “只 能 在 两 个 yield 表 达 式 之 间 使 
用 RefLikestruct”。 迭 代 堪 块 的 形 参 不 能 是 类 ref 结 构 体 。 

。 任何 被 局 部 方法 、LINQ 查 询 表 达 式 、 匿 名 方法 或 者 lambda 表 
达 式 捕获 的 局 部 变量 ， 都 不 可 以 是 类 ref 结 构 体 。 


此 外 ， 关 于 类 ref 类 型 的 ref 局 部 变量 ， 还 有 很 多 复杂 的 使 用 规则 3， 建 
议 章 从 编 详 器 的 指示 。 如 条 代码 因为 类 ref 络 构 体 而 编译 失败 ， 那 么 很 
有 可 能 是 代码 试图 获取 已 经 不 存在 于 栈 内 存 中 的 数据 。 有 了 这 些 将 值 锁 
定 在 栈 内 存 的 规则 之 后 ， 下 面 介 绍 类 ref 结 构 体 的 衍生 类 型 span<T>。 


3 解释 : 这 些 规则 不 易 理 解 。 虽 然 我 能 理解 这 些 规 则 的 大 致 目 标 ， 但 这 
些 复 杂 的 规则 多 是 为 消除 隐患 而 设置 ， 逐 条 剂 析 不 太 现 实 。 
13.6.2 ”span<T> 和 栈 内 存 分 配 


在 .NET 世 界 中 ， 访 问 一 块 区 域 的 内 存 有 多 种 方法 ， 常 用 的 有 数组 ， 有 时 
也 可 以 使 用 Arraysegment<T> 和 指针 。 直 接 使 用 数组 有 一 个 巨大 的 缺陷 : 
数组 不 单 是 一 块 大 内 存 ， 它 掌握 着 自己 的 全 部 内 存 。 这 上 听 起 来 似乎 没 什 
么 不 受 ， 但 是 如 下 所 示 的 方法 签名 会 有 问题 : 


int ReadData(byte[] buffer, int offset, int length) 












































这 种 buffer、offset 和 length 的 参数 组 合 广泛 存在 于 .NET 中 ， 其 实 是 不 
民 代 码 的 迹象 ， 昭 示 着 这 里 缺少 合理 的 抽象 。span<T> 正 是 为 解决 这 一 
问题 而 生 的 。 


说 明 ”使 用 span<T> 时 ， 有 时 只 需 添 加 对 NuGet 包 System.Memory 的 


引用 即 可 ， 有 时 还 需要 framework 的 支持 。 本 节 给 出 的 代码 都 是 基 
于 .NET Core 2.1 构 建 的 。 其 中 一 部 分 也 可 以 在 更 早 的 framework 版 
本 中 构建 。 


span<T> 是 类 ref 结 构 体 ， 具 有 读 写 属性 ， 可 以 像 数 组 那样 通过 索引 访问 
内 存 ， 但 它 并 不 拥有 这 块 内 存 。span 总 是 从 别处 创建 而 来 (可 能 是 指 
针 、 数 组 甚至 是 从 栈 内 存 直 接 创建 ) 。 使 用 Span<T> 时 ， 无 须 关 注 所 分 
配 内 存 的 位 置 。 另 外 ，span 也 可 以 进行 切 分 : 可 以 在 无 须 复制 的 情况 
下 ， 切 分 出 一 块 span 作 为 另 一 个 span 的 子 分 区 。 在 新 版 famework 中 ， 

JIT 编 译 器 可 以 识别 span<T> 并 将 其 高 度 优 化 。 


0 





。 span 可 以 指 同一 个 生命 周期 轻 度 受 限 的 内 存 ， 因 为 span 不 可 能 离开 
栈 内 存 。 负 贡 分 配 内 存 的 代码 可 以 把 span 传 递 给 其 他 代码 ， 然 后 放 
心地 释放 内 存 ， 因 为 不 会 有 残余 的 span 指 癌 未 释放 的 内 存 。 

。 span 中 的 数据 可 以 实现 自 定义 一 次 性 初始 化 ， 不 需要 任何 复制 ， 也 
不 存在 之 后 数据 被 其 他 代码 复 改 的 风险 。 


下 面 编写 一 个 创建 随机 字符 串 的 例子 ， 这 个 例子 可 以 展示 上 述 两 大 优 
势 。 昌 然 6uid.New6uid 也 可 以 用 于 创建 随机 字符 串 ， 但 有 时 需要 使 用 不 
同 的 字符 集 和 长 度 来 创建 一 些 定制 化 程度 更 高 的 随机 字符 串 。 代 码 清单 
13-20 是 传统 的 实现 方式 。 

代码 清单 13-20 ”使 用 char[] 生 成 一 个 随机 字符 串 


static string Generate(string alphabet, Random random, int length 











char[] chars = new char[length]; 
for (int i = 0; i < length; i++) 


chars[i] = alphabet[random.Next(alLlphabet .Length ) ] ; 


return new string(chars ) ; 


} 
该 方法 的 调用 代码 如 下 : 


string alphabet = "abcdefghijklmnopqrstuvwxyz"; 
Random random = new Random( ) ; 


Console.writeLine(Generate(alphabet, random, 10)); 


代码 清单 13-20 需 要 两 块 堆 内 存 的 分 配 : 一 块 给 char 数 组 ， 一 块 给 字符 
串 。 在 创建 字符 串 时 ， 这 上 段 数据 会 从 一 处 复制 到 男 一 处 。 如 果 可 以 使 用 
非 安 全 代码 ， 并 且 知 道 所 创建 的 字符 串 不 会 太 大 ， 还 可 以 使 

用 stackalloc 对 代码 做 一 些小 的 改进 ， 见 代码 清单 13-21。 


代码 清单 13-21 使 用 stackalloc 和 指针 来 实现 生成 随机 字符 串 
unsafe static string Generate(string alphabet, Random random, int 


char* chars = stackalloc char[length]; 
for (int i = 0; i < length; i++) 


chars[i] = alphabet[random.Next(alphabet.Length)]; 


return new string(chars); 


这 上 段 代码 只 有 一 次 堆 内 存 分 配 ， 为 字符 串 分 配 内 存 。 之 前 的 临时 缓冲 区 
使 用 了 栈 内 存 分 配 ， 但 是 需要 在 方法 前 添加 unsafe 修 饰 符 ， 因 为 这 里 使 
用 了 指针 。 非 安全 的 代码 令 人 不 适 ， 虽 然 我 自己 确信 这 段 代码 没有 问 
题 ， 但 是 我 不 想 使 用 指针 实现 太 多 更 复杂 的 功能 ， 而 且 这 段 代 码 仍 存 在 
从 栈 内 存 到 字符 串 的 数据 复制 。 


好 在 span<T> 支 持 stackalloc， 而 不 需要 unsafe 修 饰 符 ， 见 代码 清单 13- 
22。 之 所 以 span<T> 不 需要 unsafe 修 饰 符 ， 是 因为 类 ref 结 构 体 可 以 保证 
= 本 


代码 清单 13-22 使 用 stackalloc 和 span<char> 创 建 随机 字符 串 


static string Generate(string alphabet, Random random, int length 








Span<char> chars = stackalloc char[length]; 
for (int i = 0; i < length; i++) 


chars[i] = alphabet[random.Next(alphabet.Length)]; 


return new string(chars); 


} 
不 过 光 有 这 些 还 不 够 。 代 码 中 依然 存在 一 处 多 余 的 复制 操作 。 使 


用 system.string 的 一 个 工厂 方法 可 以 解决 这 一 问题 ， 如 下 所 示 : 


public static string Create<TState>( 
int length, TState state, SpanAction<char, TState> action) 


该 方法 用 到 了 spanAction<T， TArg>， 这 是 下 面 方法 签名 的 一 个 新 委托 : 
delegate void SpanAction<T, in TArg>(Span<T> span, TArg argd) 

这 两 个 签名 乍 看 有 些 奇 怪 ， 接 下 来 对 其 进行 详细 剖析 ， 看 看 create 的 实 
现 。 它 完成 了 以 下 几 个 步骤 : 

(1) 根据 要 求 的 长 度 分 配 一 个 字符 串 ， 

(2) 创建 一 个 指向 该 学 符 串 的 span:; 

(3) 调用 action 委 托 ， 回 委托 传递 pgan 和 方法 的 状态 ; 

(4) 返回 字符 串 。 

首先 需要 注意 : 该 委托 可 以 向 字符 串 进行 写 入 。 这 一 点 似乎 和 字符 串 的 
不 可 变性 相 违 上 背 ， 但 这 里 由 create 方 法 主宰 ， 因 此 可 以 同 字 符 串 写 入 任 
何 内 容 ， 束 像 创 建 并 初始 化 新 字符 串 一 样 。 当 字符 串 返回 时 ， 其 内 容 融 


确定 下 来 了 。 我 们 也 不 能 保留 传递 给 委托 的 Span<char>， 因 为 编译 器 会 
确保 其 不 会 脱离 栈 内 存 。 

还 有 一 个 关于 参数 state 的 疑问 ， 为 什么 需要 传 入 state， 然 后 回 传 给 委 
托 呢 ? 示例 如 下 ， 代 码 清单 13-23 用 create 方 法 实现 随机 字符 串 生 成 
器 。 


代码 清单 13-23 ”使 用 string.create 创 建 随机 字符 串 


static string Generate(string alphabet, Random random, int length 
string.Create(length, (alphabet, random), (span, state) => 


{ 

















var alphabet2 = state.alphabet; 
var random2 = state.random; 
for (int i = 0; i < span.Length; i++) 


span[i] = alphabet2[random2.Next(alphabet2.Length)]; 


}); 


起 初 ， 我 们 会 觉得 其 中 有 太 多 无 意义 的 重复 代码 。string.create 的 第 2 
个 实 参 是 (alphabet，random)， 它 把 alphabet 和 random 放 到 一 个 元 组 中 
作为 state， 然 后 在 lambda 表 达 式 中 又 把 这 个 元 组 拆 解 开 了 : 


var alphabet2 = state.alphabet ， 
var random2 = state.random; 


为 什么 不 能 在 lambda 表 达 式 中 直接 捕获 这 两 个 参数 呢 ?” 和 直接 在 lambda 表 
达 式 中 使 用 alphabet 和 random 既 能 通过 编译 ， 又 能 正常 运行 ， 为 什么 需 
要 一 个 额外 的 state 参 数 呢 ? 


请 记 住 使 用 span 的 目的 : 减少 复制 和 堆 内 存 的 分 配 。 当 lambda 表 达 式 捕 
获 参 数 或 者 局 部 变量 时 ， 它 必须 创建 一 个 生成 类 的 实例 ， 这 样 委托 才能 
访问 这 些 变量 。 代 码 清单 13-23 中 的 lambda 表 达 式 无 须 捕 获 任何 东西 ， 
编译 器 残 能 生成 一 个 静态 方法 ， 然 后 绥 存 一 个 委托 实例 ， 以 供 每 

次 Generate 调 用 。 所 有 state 都 是 通过 参数 传递 给 string.create 的 ， 因为 
C# 7 的 元 组 是 值 类 型 ， 所 以 对 于 state 不 需要 内 存 分 配 。 


至 此 ， 字 符 串 生成 器 终于 可 堪 大 用 了 : 只 需要 一 次 堆 内 存 分 配 ， 而 且 没 
有 任何 数据 复制 。 代 码 直接 向 字符 串 中 写 入 数据 。 


这 只 是 span<T> 所 能 实现 的 一 个 小 例子 。 相 关 的 
ReadOonlySpan<T>、 Memory<T> 以 及 ReadonlyMemory<T> 几 个 类 型 更 重要 ， 


不 过 本 书 不 做 深入 探讨 。 


重要 的 是 ， 优 化 之 后 的 Generate 方 法 根本 不 需要 改变 它 的 方法 签名 。 这 
古 一 个 纯粹 实现 层面 的 改动 ， 将 实现 变化 与 外 部 代码 隅 离开 来 ， 值 得 称 
道 。 虽 然 通 过 引用 传递 结构 体 也 能 避免 大 量 复制 操作 ， 但 这 属于 侵入 性 
的 改动 ， 我 更 喜欢 零散 的 、 有 针对 性 的 优化 。 


string 类 型 已 经 增加 利用 span 的 新 方法 ， 其 他 类 型 也 会 紧 随 其 后 。 对 于 
任何 基于 IO 的 操作 ， 在 framework 中 都 会 有 相应 的 异步 方法 ， 随 着 时 间 
的 推移 ，span 应 该 也 会 如 此 。span 能 发 挥 作 用 的 地 方 ， 都 应 当 提供 相应 
的 方法 。 第 三 方 库 也 会 提供 接收 span 的 重 载 方法 。 


1. 在 初始 化 器 中 使 用 stackalloc (C#7.3) 























天 于 栈 内 存 分 配 ，C# 7.3 也 为 此 新 增 了 一 个 变动 : 初始 化 莫 。 在 以 
前 的 版 本 中 ， 使 用 stackalloc 时 必须 为 其 提供 一 个 分 配 内 存 大 小 的 
值 ， 到 了 C# 7.3， 可 以 为 这 块 内 存 指定 内 容 了 。 对 于 指针 和 span， 
下 面 这 两 种 方式 都 是 合法 的 : 


Span<int> Span = stackalloc int[] { 1， 2, 3 }; 
int* pointer = stackalloc int[] { 4, 5, 6 }; 


里 然 与 完 分 配 内 存 然后 填充 数据 相 比 ， 新 写法 的 效率 提升 并 不 明 
显 ， 但 可 读 性 的 增强 是 毋庸 置疑 的 。 


2. 基于 模式 的 fixed 语 句 〈C# 7.3) 


要 点 回顾 : fixed 语 句 用 于 获取 指 同 某 块 内 存 的 指针 ， 可 以 暂时 阻 
止 垃圾 回收 器 回收 这 部 分 数据 。 在 C# 7.3 之 前 ， 它 只 能 用 于 数组 、 
字符 串 以 及 获取 变量 的 地 址 。C# 7.3 则 将 其 扩展 到 了 所 有 类 型 ， 只 
需要 该 类 型 有 一 个 名 为 GetPinnableReference 的 方法 用 于 返回 一 个 
非 托管 类 型 的 引用 即 可 。 如 果 有 一 个 返回 ref int 的 方法 ， 那 么 它 
可 以 使 用 fixed 语 句 : 


fixed (int* ptr = Value) <------ 调用 valLue .GetPinnableReferenc 


Ee 使 用 指针 的 代码 
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即便 是 那些 经 常 和 非 安全 代码 打交道 的 少数 程序 员 ， 通 常 也 不 需要 
自己 实现 。span<T> 和 Readonlyspan<T> 类 型 更 常用 ， 通 过 它们 足以 
和 已 经 使 用 了 指针 的 代码 进行 交互 。 


13.6.3 ”类 ref 结 构 体 的 下 表示 


类 ref 结 构 体 会 由 [IsRefLikeAttribute] 修 饰 ， 该 attribute 来 自 
System.Runtime.CompilerServices 命 名 空间 。 如 果 目 标 framework 没 有 
提供 该 attribute， 那 么 程序 集中 会 创建 。 


与 in 参 数 不 同 ， 编 译 器 不 会 使 用 modreq 修 饰 符 来 要 求 使 用 该 类 型 的 工具 
识别 它 ， 而 是 添加 一 个 [obsoleteAttribute] 到 该 类 型 中 ， 并 且 提 供 一 条 
固定 的 消息 。 任 何 能 够 识别 [TsRefLikeAttribute] 的 编译 器 ， 在 消息 正 


确 的 情况 下 ， 都 可 以 忽略 [obsoleteAttribute]。 如 果 访 类 型 的 作者 想 废 
除 该 类 型 ， 只 需要 使 用 [obsoleteAttribute] 即 可 ， 而 编译 器 会 把 它 当 作 
过 期 类 型 。 


人 了 车 


C# 7 在 很 多 领域 中 增加 了 按 引 用 传递 的 语义 支持 。 

C# 7.0 只 包含 最 初 的 几 个 特性 ，C# 7.3 则 襄 括 了 全 部 特性 。 
ref 相 关 特 性 的 目标 是 提升 性 能 。 如 果 编 写 的 代码 不 需要 注重 性 
能 ， 那 么 很 多 相关 特性 就 用 不 上 。 

类 ref 结 构 体 使 得 可 以 在 framework 中 引入 新 的 抽象 。 这 些 抽象 都 是 
为 了 提升 性 能 ， 随 着 时 间 的 推移 ， 很 多 .NET 开 发 人 员 会 受 影响 。 


第 14 章 C# 7 的 代码 简洁 之 道 
本 章 内 容 概览 


。 如 何在 方法 内 部 声明 方法 ; 
。 如 何 使 用 out 参 数 简 化 方法 调用 ; 
。 如 何 增 强 数字 字面 量 的 可 读 性 ; 





如 何 把 throw 用 作 表 达 式 ; 
如 何 使 用 default 字 面 量 。 


C# 7 引入 了 和 寿 干 改变 开发 人 员 编 程 习惯 的 新 特性 : 元 组 、 分 解 以 及 模式 
匹配 。 一 些 复杂 但 高 效 的 特性 剑 指 高 性 能 场景 。 此 外 ， 还 有 一 些小 特 

性 ， 能 为 编码 提供 便利 。 本 章 要 介绍 的 特性 都 不 是 什么 了 不 起 的 特性 ， 
和 








14.1 局 部 方法 


如 果 本 书 的 名 字 没 有 “深入 解析 ”这 几 个 字 ， 这 部 分 内 容 会 很 短 ， 因 为 访 
特性 直 白明 了 ， 在 方法 内 部 编写 方法 。 不 过 ， 需 要 深入 剖析 该 特性 ， 首 
先 看 一 个 简单 的 例子 。 在 代码 清单 14-1 中 ， 普 通 Main 方 法 之 中 有 一 个 局 
部 方法 。 该 局 部 方法 打印 Main 方 法 中 的 一 个 局 部 变量 ， 并 将 其 值 进行 自 
增 ， 证 明 该 局 部 方法 可 以 正常 捕获 变量 。 


代码 清单 14-1 局 部 方法 访问 局 部 变量 


static void Main() 

{ 
int x = 10; <------ 声明 一 个 局 部 变量 在 方法 内 部 使 用 
PrintAndIncrementX(); (本 行 及 以 下 1 行 ) 两 次 调用 局 部 方法 
PrintAndIncrementX( ) ， 
Console.WriteLine($"After calls, x = {x}"); 









































void PrintAndIncrementX() (本 行 及 以 下 4 行 ) 局 部 方法 


Console.writeLine($"x = {x}"); 
x++; 


} 


这 种 代码 乍 一 看 会 有 些 奇 怪 ， 但 很 快 就 可 以 适应 。 在 任何 有 知 干 语句 出 
现 的 位 置 ， 都 可 以 使 用 局 部 方法 : 方法 、 构 造句 、 属 性 、 索 引 器 、 事 件 
访问 器 、 终 结 器 、 匿 名 函数 中 甚至 男 一 个 馆 套 的 局 部 方法 中 。 


局 部 方法 和 普通 方法 的 声明 方法 基本 一 致 ， 但 有 如 下 限制 条 件 : 


。 不 能 有 访问 修饰 符 (public、private 等 ); 

@ 不 能 使 用 extern、 virtual、new、override、static 或 者 abstract 
修饰 符 ; 

。 不 能 应 用 attribute 〈 例 如 MethodImp1) ; 

。 不 能 与 同 级 的 其 他 局 部 方法 重 名 ， 局 部 方法 没有 方法 重 载 。 


除 此 以 外 ， 局 部 方法 和 普通 方法 的 行为 一 致 : 


可 以 有 或 者 没有 返回 值 ; 

可 以 有 async 修 饰 符 ; 

可 以 有 unsafe 修 饰 符 ; 

可 以 通过 迭代 器 块 实现 ; 

可 以 有 形 参 ， 包 括 可 选 形 参 ; 
可 以 是 泛 型 方法 ; 

可 以 指 癌 任何 闭合 的 类 型 形 参 ; 
可 以 是 某 个 方法 组 转换 的 目标 。 


如 代码 清单 14-1 所 示 ， 局 部 方法 可 以 在 调用 它 的 位 置 之 后 声明 。 局 部 方 
法 可 以 调用 目 身 ， 也 可 以 调用 其 范围 内 的 其 他 局 部 方法 。 不 过 就 局 部 方 
法 如 何 使 用 捕获 变量 而 言 ， 局 部 方法 的 位 置 依然 很 重要 : 局 部 变量 在 闭 
包 代 码 中 声明 ， 在 局 部 方法 中 使 用 。 


关于 局 部 方法 的 种 种 复杂 规则 “〈 不 管 是 语言 上 的 规则 ， 还 是 实现 上 的 规 
则 ) ， 都 是 围绕 局 部 方法 读 / 写 捕获 变量 而 展开 的 。 首 先 介 绍 语言 层面 
的 规则 。 

14.1.1 局 部 方法 中 的 变量 访问 


如 前 所 述 ， 闭 包 块 中 的 局 部 变量 可 以 被 局 部 方法 读 写 ， 但 其 中 还 有 很 多 


















































细节 需要 注意 。 虽 然 该 过 程 涉及 很 多 细小 的 规则 ， 但 是 无 须 全 盘 消 化 。 
在 多 数 情 况 下 ， 我 们 甚至 注意 不 到 它们 的 存在 。 当 发 生 编 译 报错 并 且 找 
不 到 原因 时 ， 可 以 再 回顾 这 部 分 内 容 。 
1. 局 部 方法 只 能 捕获 作用 域内 的 变量 
局 部 方法 不 能 使 用 作用 域外 的 局 部 变量 。 这 里 的 作用 域 指 方法 声明 
所 在 的 代码 块 。 假 设 有 一 个 局 部 方法 需要 使 用 在 循环 内 部 声明 的 变 
人 
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static void Invalid() 











{ 
for (int i = 0; i < 10; i++) 
PrintI(); 
void PrintI() => Console.WriteLine(i); <------ 无 法 访问 变量 


如 果 该 方法 在 循环 内 ， 就 是 合法 的 1: 
static void Valid() 
for (int i = 0; i < 10; i++) 
PrintI(); 


void PrintI() => Console.WriteLine(i); <------ 将 局 部 7 











2. 局 部 方法 必须 在 其 捕获 的 变量 声明 之 后 声明 


不 能 在 变量 声明 前 使 用 该 变量 。 同 理 ， 也 不 能 在 变量 声明 前 捕获 该 
变量 。 这 条 原则 主要 是 出 于 一 致 性 的 考虑 ， 而 非 必 要 性 。 与 其 要 求 
必须 在 变量 声明 之 后 调用 方法 ， 不 如 要 求 所 有 访问 都 必须 在 声明 之 
后 更 简单 。 下 面 这 个 例子 也 是 非法 的 : 














static void Invalid() 


{ 
void PrintI() => Console.WwriteLine(i); <------ CS0841: 不 和 
int i = 10; 
PrintI(); 


只 需 把 局 部 方法 声明 放 在 变量 声明 之 后 就 是 合法 代码 了 
《在 PrintI() 调 用 之 前 和 之 后 都 可 以 ) 。 


. 局 部 方法 不 能 捕获 ref 参 数 
和 匿名 函数 一 样 ， 局 部 方法 不 能 使 用 朵 包 方 法 中 的 ref 参 数 ， 例 如 
以 下 代码 非法 : 
static void Invalid(ref int p) 
PrintAndIncrementP(); 


void PrintAndIncrementP() => 
Console.wWriteLine(p++); <------ 对 ref 参 数 的 非法 访问 





} 


匿名 函数 之 所 以 有 这 项 限制 ， 是 因为 创建 的 委托 可 能 比 它 所 捕获 的 
变量 生命 周期 长 。 不 过 这 一 原因 基本 上 不 适用 于 局 部 方法 ， 但 后 面 
会 看 到 ， 局 部 方法 也 存在 这 种 生命 周期 不 一 致 的 问题 。 多 数 情况 
下 ， 可 以 在 局 部 方法 中 声明 一 个 新 参数 ， 然 后 把 引用 参数 通过 引用 
的 方式 再 传递 一 次 : 


static void Valid(Cref int p) 











PrintAndIncrement(ref p); 
void PrintAndIncrement(ref int x) => Console.writeLine(x+ 


} 
如 果 在 局 部 方法 中 不 需要 修改 参数 值 ， 也 可 以 使 用 值 参数 传递 。 


这 一 限制 必然 导致 《还 是 参考 匿名 函数 ) : 在 结构 体 中 声明 的 局 部 
方法 不 能 访问 tnis。 可 以 把 this 视 作 每 个 实例 方法 参数 列表 中 的 一 
个 隐 含 参数 。 对 于 关 方 法 ， 它 是 一 个 值 参数 ;但 是 对 于 结构 体 方 
法 ， 它 束 是 引用 参数 。 因 此 ， 类 中 的 局 部 方法 可 以 捕获 this， 但 是 
结构 体 不 可 以 。 这 一 点 对 于 其 他 引用 参数 也 适用 。 

















说 明 ”本 书 附带 的 源码 文件 LocalMethodUsingThisInStruct.cs 中 
有 一 个 相关 示例 。 








4. 局 部 方法 与 “确定 赋值 ? 


C# 中 “确定 赋值 ?的 规则 很 复杂 ， 有 了 局 部 方法 之 后 就 更 复杂 了 。 最 
简单 的 思考 模型 是 ， 把 所 有 局 部 方法 调用 都 看 作 内 联 调用 。 局 部 方 
法 从 两 个 方面 影响 赋值 。 


首先 ， 如 果 一 个 方法 在 变量 确定 赋值 之 前 束 将 其 作为 捕获 变量 进行 
读 取 ， 则 会 导致 编译 错误 。 下 面 这 个 例子 中 ， 变 量 i 被 局 部 方法 捕 
获 ， 然 后 在 它 赋 值 前 和 赋值 后 分 别 打印 i 的 值 。 


static void AttemptToReadNotDefinitelyAssignedVariable() 
{ 
































int 1; 

void PrintI() => Console.writeLine(i); 
PrintI(); <------ CS0165: 使 用 了 未 赋值 的 变量 i 
i = 10; 

PrintI(); <------ 合法 。 此 时 i 已 经 是 确定 赋值 的 
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注意 ， 是 PrintI() 方 法 调用 所 处 位 置 引发 了 编译 错误 ， 而 非 方 法 声 
明 的 位 置 。 只 要 把 i = 16 这 人 句 代 人 码 放 到 所 有 PrintI() 方 法 调用 之 前 
就 可 以 解决 该 报错 ， 无 论 i = 16 在 局 部 方法 声明 之 前 还 是 之 后 。 
其 次 ， 如 果 局 部 方法 能 够 做 到 在 所 有 执行 路 径 上 都 给 捕获 变量 赋 
值 ， 那 么 在 局 部 方法 调用 结束 时 ， 该 变量 就 是 确定 赋值 的 。 下 面 这 
个 例子 中 的 局 部 方法 对 捕获 变量 赋值 后 在 外 部 方法 中 读 取 该 变量 。 


static void DefinitelyAssignInMethod() 



























































上 . 
int 1; 
AssignI(); <------ 调用 该 方法 会 使 变量 i 确定 赋值 
Console.WriteLine(i); <------ 可 以 打印 二 的 值 
void AssignI() => i = 10; <------ 执行 赋值 的 方法 
} 





关于 局 部 方法 和 变量 之 间 的 关系 ， 还 有 几 点 需要 讨论 ， 只 不 过 不 是 
关于 捕获 变量 ， 而 是 关于 字段 。 








5. 局 部 方法 不 能 给 只 读 字 段 赋值 
只 读 字 段 只 能 在 字段 初始 化 器 或 者 构造 右 中 进行 赋值 。 有 了 局 部 方 
法 之 后 ， 该 规则 依然 成 立 ， 不 过 增加 了 一 项 小 的 补充 条 球 : 即便 在 
构造 占 中 声明 的 局 部 方法 ， 对 变量 的 赋值 也 不 能 算 作 和 字段 初始 化 。 
例如 下 面 这 段 代码 非法 : 


class Demo 








private readonly int value; 
public Demo() 
{ 


AssignValue( ); 
void AssignValue() 





value = 10; <------ 对 只 读 变 量 的 非法 赋值 





} 
} 


这 项 限制 不 是 什么 大 问题 ， 但 仍 需 注意 。 这 项 限制 是 为 了 保证 局 部 
方法 只 是 编译 时 的 一 个 转换 ，CLR 无 须 为 其 做 任何 变更 。 下 面 研究 
编译 器 针对 局 部 方法 做 了 何 种 转换 ， 尤 其 是 对 于 捕获 变量 而 言 。 


1 里 然 看 起 来 比较 奇怪 ， 但 确实 是 合法 的 。 








14.1.2 局 部 方法 的 实现 


在 CLR 层 面 不 存在 局 部 方法 的 概念 2。C# 编 译 器 负责 把 局 部 方法 转换 成 
普通 方法 ， 转 换 原 则 是 让 最 终 代 码 的 行为 不 违反 语言 规则 。 稍 后 展示 由 
Roslyn 编 译 器 实现 的 转换 示例 ， 重 点 关注 编译 器 如 何 处 理 捕 获 变 量 。 捕 
获 变量 的 处 理 是 该 转换 过 程 中 最 复杂 的 部 分 。 


2 如 果 C# 编 译 器 的 目标 环境 是 支持 局 部 方法 的 ， 那 么 下 面 所 述 内 容 束 与 
该 编译 右 无 天 了 。 


实现 细节 : 不 确保 任何 东西 

















这 部 分 只 讨论 Roslyn 编 译 器 对 于 C# 7.0 局 部 方法 的 实现 。 在 未 来 的 
Roslyn 版 本 中 ， 实 现 方 式 可 能 会 发 生变 化 ， 而 其 他 C# 编 详 占 也 可 能 
有 不 同 的 实现 方式 ， 这 就 意味 着 该 者 可 能 无 须 关 注 这 部 分 的 东 些 细 
i 














实现 方式 确实 会 影响 程序 性 能 ， 因 此 在 性 能 敏感 的 代码 中 使 用 局 部 
方法 需要 慎重 再 三 。 不 过 ， 对 于 性 能 问题 也 不 能 一 概 而 论 ， 还 是 要 
坚持 通过 认真 测试 和 衡量 来 做 决定 ， 而 不 是 根据 理论 来 决 集 。 


虽然 局 部 方法 和 匿名 函数 都 能 从 周围 代码 捕获 变量 ， 但 二 者 在 实现 层面 
存在 巨大 差异 ， 这 就 使 得 局 部 方法 在 很 多 场景 中 的 效率 会 高 出 一 筹 。 其 
根本 原因 在 于 捕获 局 部 变量 的 生命 周期 。 如 果 匿 名 函数 被 转换 成 委托 实 
例 ， 委 托 可 能 要 等 到 该 方法 返回 许久 之 后 才 会 执行 ， 因 此 编译 器 需要 使 
负 
| 


局 部 方法 的 实现 则 不 同 : 多 数 情 况 下 ， 局 部 方法 只 能 在 牡 主 方法 内 部 进 
行 调 用 ， 因 此 无 须 理 会 局 部 方法 调用 结束 后 它 所 捕获 的 变量 问题 。 局 部 
方法 实现 起 来 会 更 高 效 ， 因 为 只 需要 操作 栈 内 存 而 不 牵涉 扒 内 存 分 配 。 

下 面 举例 说 明 该 过 程 。 代 码 清单 14-2 中 有 一 个 局 部 方法 ， 它 捕获 了 一 个 
Bi 
] 居 参 但 。 


代码 清单 14-2 ”使 用 局 部 方法 修改 某 个 局 部 变量 值 


static void Main() 
































int i = 0; 

AddToI(5); 

AddToI (10); 

Console.writeLine(i); 

void AddToI(int amount) => i += amount; 


} 


Roslyn 编 译 器 如 何 处 理 这 个 局 部 方法 呢 ? 编译 器 会 创建 一 个 私有 的 可 变 
结构 体 ， 结 构 体 中 的 公共 字段 表示 所 有 同 作用 域 的 捕获 变量 ， 在 本 例 中 
就 是 i 变量 。 编 译 器 会 在 Main 方 法 中 创建 一 个 该 结构 体 类 型 的 变量 ， 人 然 
Be 
清单 14-3。 











代码 清单 14-3 ”代码 清单 14-2 经 Roslyn 编 译 器 处 理 后 的 结果 


private struct MainLocals <------ 生成 的 可 变 结构 体 ， 用 于 保存 Main 方 法 中 | 








public int 工 ; 


static void Main() 








MainLocals locals = new MainLocals(); (本 行 及 以 下 1 行 ) 在 方法 内 部 人 
locals.i = 0 

AddToI(5，ref locals); (本 行 及 以 下 1 行 ) 通过 引用 将 结构 体 传递 给 生成 的 7 
AddToI(10, ref locals); 

Console.writeLine(locals.i); 








} 


static void AddToI(int amount，ref MainLocals locals) (本 行 及 以 下 3# 


locals.i += amount 





一 如 往常 ， 编 译 如 会 为 方法 和 结构 体 生成 “ 难 言 之 名 ”。 在 本 例 中 ， 编 译 
器 为 AddToI 生 成 的 方法 是 静态 方法 。 当 该 局 部 方法 的 宿主 是 静态 成 员 或 
者 实例 成 员 ， 但 局 部 方法 不 捕获 this 时 《〈 显 式 地 或 者 隐 式 地 在 局 部 方法 
中 使 用 实例 成 员 ) ， 编 译 需 就 会 生成 静态 方法 。 


关于 生成 结构 体 ， 一 个 重点 是 ， 这 一 转换 过 程 儿 乎 没有 损耗 。 原 来 位 于 
栈 内 存 的 变量 依然 位 于 栈 内 存 上 。 这 些 变量 只 是 通过 一 个 结构 体 聚 合 到 
了 一 起 ， 这 样 就 可 以 通过 引用 传递 的 方式 传递 给 生成 的 方法 了 。 通 过 引 
用 传递 结构 体 有 以 下 两 个 好 处 。 
。 局 部 方法 可 以 修改 局 部 变量 。 
。 无 论 有 多 少 局 部 变 锐 捕获 ， 对 局 部 方法 调用 的 性 能 影响 都 很 小 。 

( 相 比 之 下 ， 值 传递 会 导致 每 个 捕获 变量 都 发 生 一 次 复制 。) 


以 上 过 程 没有 产生 任何 堆 内 存 垃圾 ， 实 在 妙 不 可 言 。 下 面 考虑 更 复杂 的 
场景 。 


1. 在 多 个 作用 域 捕获 变量 


在 匿名 方法 中 ， 如 果 捕 获 的 局 部 变量 来 自 多 个 作用 域 ， 就 会 生成 多 
个 类 ， 每 个 类 都 表示 一 个 作用 域 ， 每 个 类 都 有 一 个 字段 用 于 指 同 外 












































部 作用 域 的 实例 。 这 种 方式 对 于 局 部 方法 的 结构 体 并 不 适用 ， 因 为 
其 中 这 涉 复制 操作 。 编 译 占 会 为 每 个 作用 域 生 成 一 个 结构 体 ， 这 些 
结构 体 都 包含 各自 的 捕获 变量 ， 每 个 作用 域 使 用 不 同 的 参数 。 代 码 
清 蛙 14-4 创 建 了 两 个 作用 域 ， 看 看 编译 器 是 如 何 处 理 的 。 

代码 清单 14-4 从 多 个 作用 域 捕获 变量 
static void Main() 

DateTime now = DateTime.UtcNow; 

int hour = now.Hour; 


if (hour > 5) 


int minute = now.Minute ， 
PrintValues( ); 


void PrintValues() => 
Console.writeLine($"hour = {hour}; minute = {minu 


} 
这 段 代 码 采 用 if 语句 来 引入 新 的 作用 域 而 不 是 采用 for 循 环 或 
者 foreach 循 环 ， 因 为 这 样 能 让 转换 过 程 更 简单 、 更 精准 。 代 码 清 
单 14-5 是 编译 器 将 局 部 方法 转换 成 普通 方法 后 的 结果 。 

代码 清单 14-5 ”代码 清单 14-4 经 Roslyn 编 译 器 转换 后 的 结 
struct OuterScope (本 行 及 以 下 3 行 ) 为 外 层 作 用 域 生 成 的 结构 体 
{ 





public int hour; 


} 
struct InnerScope (本 行 及 以 下 3 行 ) 为 内 层 作 用 域 生 成 的 结构 体 





public int minute 


} 


static void Main() 

{ 
DateTime now = DateTime.UtcNow; <------ 未 被 捕获 的 局 部 变量 
OuterScope outer = new OuterScope(); (本 行 及 以 下 1 行 ) 为 外 层 人 
outer .hour = now.Hour; 
if (outer.hour > 5) 





InnerScope inner = new InnerScope(); (本 行 及 以 下 1 行 ) 为 


Inner ,minute = now.Minute ， 
PrintValues(ref outer, ref inner); <------ 按 引 用 结构 体 





} 
} 


static void PrintValues( (本 行 及 以 下 1 行 ) 为 原始 局 部 方法 生成 的 方法 
ref OuterScope outer, ref InnerScope inner) 














Console.writeLine($"hour = {outer.hour}; minute = {inner. 








这 段 代码 除了 展示 编译 需 对 多 个 作用 域 的 处 理 ， 还 传递 了 一 条 信 
恩 未 被 捕获 的 局 部 变量 不 会 包含 在 生成 的 结构 体 中 。 


在 前 面 的 例子 中 ， 局 部 方法 只 会 在 宿主 方法 执行 时 执行 。 在 这 种 情 
况 下 ， 捕 获 局 部 变量 是 安全 的 行为 。 虽 然 根据 我 的 经 验 ， 大 部 分 情 
况 在 这 个 范围 内 ， 但 仍 有 一 些 例外 。 








.摆脱 禁 铀 ! 局 部 方法 如 何 摆脱 宿主 代码 


像 普 通 方法 那样 阻止 编译 器 执行 “把 所 有 操作 都 控制 在 栈 内 存 之 
上 ”的 优化 ， 局 部 方法 有 以 下 4 种 方式 。 


o 局 部 方法 可 以 是 异步 方法 ， 这 样 立 即 返 回 任务 的 调用 不 需要 已 
经 执行 完 逻 辑 操作 。 
局 部 方法 可 以 使 用 迭代 器 实现 ， 当 癌 序 列 请 求 下 一 个 值 时 ， 创 
建 该 序列 的 调用 需要 可 以 继续 执行 该 方法 。 
局 部 方法 可 以 由 匿名 函数 调用 ， 匿 名 函数 作为 委托 可 以 在 宿主 
方法 执行 结束 很 久之 后 才 被 调用 。 
局 部 方法 可 以 是 方法 组 转换 的 目标 ， 创 建 的 委托 也 可 以 比 原 方 
法 调用 的 生命 周期 长 。 
关于 最 后 一 条 ， 参 见 以 下 示例 。 在 代码 清单 14-6 中 ， 局 部 方法 
count 捕 获 了 一 个 位 于 宿主 方法 createcounter 中 的 局 部 变量 。count 
方法 创建 一 个 Action 委 托 ， 该 委托 在 createcounter 方 法 执行 结束 之 
后 被 调 起 。 

代码 清单 14-6 局 部 方法 的 方法 组 转换 


static void Main() 








O 


O 〇 


O 〇 





Action counter = CreateCounter(); 
counter(); (本 行 及 以 下 1 行 ) CreateCounter 方 法 完成 后 调用 委托 
Counter( ) ; 

















} 
static Action CreateCounter() 
{ 
int count = 0; <------ Count 方 法 可 以 捕获 的 局 部 变量 
return Count; <------ Count 方 法 到 Action 委 托 的 方法 组 转换 
void Count() => Console.writeLine(count++); <------ 局 部 方 
} 


在 这 种 情况 下 ， 就 无 法 再 在 栈 内 存 上 使 用 count 结 构 体 了 。 这 是 因 
为 当 委 托 被 调 起 时 ，createcounter 已 经 不 在 栈 上 了 了。 此 时 十 分 类 
似 于 匿名 函数 : 可 以 使 用 lambda 表 达 式 来 实现 Createcounter 方 法 。 


static Action CreateCounter() 
{ 
(©) a 


int count > 
> Console.writeLine(count++); <------ 使 用 lambc 


return () 


3: 


这 样 就 能 找 出 些 编译 器 实现 该 局 部 方法 的 线索 : 按照 类 似 于 lambda 
表达 式 的 方式 转换 局 部 方法 ， 见 代码 清单 14-7。 


代码 清单 14-7 ”代码 清单 14-6 经 Roslyn 编 译 器 转换 后 的 结 


static void Main() 





{ 
Action counter = CreateCounter(); 
counter(); 
counter(); 

} 


static Action CreateCounter() 





CountHolder holder = new CountHolder(); (本 行 及 以 下 1 行 ) 创建 
holder .count = 0 




















return holder.Count，<------ holder 实 例 方法 的 方法 组 转换 
} 
private class CountHolder <------ 保存 捕获 变量 和 局 部 方法 的 私有 类 
{ 





public int count; <------ 捕获 的 变量 


public void Count() => Console.WriteLine(count++); <----- 


匿名 函数 内 的 局 部 方法 (如 果 是 async 方 法 或 迭代 器 〉 在 调用 时 ， 
也 会 发 生 类 似 的 转换 。 如 果 读 者 对 性 能 敏感 ， 可 能 会 意识 到 这 种 方 
式 会 创建 多 个 对 象 。 如 果 既 要 使 用 局 部 方法 ， 又 想 尽量 避免 堆 内 存 
分 配 ， 那 么 把 这 些 变 量 显 式 地 通过 参数 传递 给 局 部 方法 更 好 ， 而 不 
征 让 局 部 方法 去 捕获 它们 ， 稍 后 给 出 具体 示例 。 


当然 ， 可 能 的 情况 不 止 于 此 。 某 个 局 部 方法 可 能 是 力 一 个 局 部 方法 
的 方法 转换 ， 或 者 局 部 方法 在 async 方 法 内 部 使 用 ， 等 等 。 这 部 分 
内 容 旨 在 大 致 介绍 编译 圳 是 如 何 处 理 这 两 种 捕获 变量 的 。 如 有 果 想 探 
完 手头 代码 背后 的 转换 逻辑 ， 可 以 使 用 杀 个 反 编译 工具 或 者 
ildasm， 不 过 要 记得 关闭 编译 器 相关 的 优化 选项 《〈 人 否则 会 只 显示 局 
部 方法 ， 达 不 到 反 编 译 的 目的 ) 。 了 解 了 局 部 方法 的 功能 和 实现 原 
理 后 ， 下 面 介 绍 局 部 方法 的 适用 场景 。 


14.1.3 ”使 用 指南 
局 部 方法 的 适用 场景 主要 有 以 下 两 种 模式 : 


。 在 某 个 方法 中 存在 多 处 重复 的 逻辑 ; 
。 存在 只 用 于 单一 方法 的 私有 方法 。 


第 2 种 情况 属于 第 1 种 情况 的 一 个 特例 一 一 重 构 方 法 中 重复 的 逻辑 ， 集 中 
到 一 个 私有 方法 中 。 利 用 局 部 方法 捕获 局 部 变量 的 能 力 ， 风 辑 抽象 的 重 
构 会 更 有 了 吸引 力 。 


在 将 现 有 方法 重 构 为 局 部 方法 时 ， 建 议 明 确 采 取 以 下 两 步 措 施 。 首 先 ， 

把 这 个 单一 用 途 的 方法 在 不 改变 其 签名 的 情况 下 ， 迁 移 到 使 用 它 的 位 

置 3。 接 下 来 查看 方法 的 参数 ， 明 确 该 方法 的 所 有 调用 是 人 否 都 使 用 局 部 
变量 作为 实 参 。 知 是 如 此 ， 可 以 用 捕获 变量 蔡 换 这 些 参数 ， 有 时 其 全 可 
以 直接 删除 所 有 参数 。 


3 有 时 需要 对 签名 中 的 类 型 形 参 做 改动 。 如 果 是 一 个 泛 型 方法 调用 为 外 
一 个 泛 型 方法 ， 通 常 在 把 第 2 个 方法 移动 到 第 1 个 方法 内 部 时 ， 可 以 直接 
使 用 第 1 个 方法 的 类 型 形 参 。 代 码 清早 14-9 展 示 了 这 一 过 程 。 





















































使 用 局 部 方法 的 一 个 重点 在 于 : 是 在 表达 这 部 分 代码 属于 茶 个 方法 的 实 
现 细 市 ， 而 不 是 类 型 的 实现 细节 。 如 果 有 茶 个 私有 方法 ， 其 存在 只 是 作 
为 一 个 操作 ， 但 目前 只 用 于 一 处 ， 保 持原 状 为 好 。 就 逻辑 类 型 结构 来 





人 


1. 友 代 需 /async 方 法 参数 校 验 以 及 局 部 方法 优化 


当 迭 代 吉 或 者 async 方 法 需要 做 积极 的 参数 校 验 时 ， 可 以 考虑 使 用 
局 部 方法 进行 优化 。 代 码 清 单 14-8 包 含 了 LINQ to Objects 中 的 
select 重 载 方法 的 实现 代码 。 参 数 校 验 的 部 分 不 在 迭代 器 块 中 ， 因 
此 在 方法 调用 的 一 开始 束 能 执行 ， 但 foreach 循 环 直到 调用 方 对 返 
回 的 序列 开始 进行 迭代 之 后 才 会 执行 。 


代码 清单 14-8 不 使 用 局 部 方法 来 实现 select 方 法 


public static IEnumerable<TResult> Select<TSource, TResult>( 
this IEnumerable<TSource> source, 
Func<TSource, TResult> selector) 


























{ 
Preconditions.CheckNotNull(source, nameof(source)); (本 行 ) 
Preconditions.CheckNotNull( 
selector, nameof(selector)); 
return SelectIimpl(source, selector); <------ 代理 方法 实现 
} 


private static IEnumerable<TResult> SelectIimpl<TSource, TResu 
IEnumerable<TSource> source, 
Func<TSource, TResult> selector) 


' foreach (TSource item in source) (本 行 及 以 下 3 行 ) 缓 步 执行 的 实 
yield return selector(item); 

} 

使 用 局 部 方法 ， 可 以 把 实现 部 分 转移 到 select 方 法 内 部 ， 如 下 所 

外。 


代码 清单 14-9 使 用 局 部 方法 实现 Select 方法 


public static IEnumerable<TResult> Select<TSource, TResult>( 
this IEnumerable<TSource> source, 


Func<TSource, TResult> selector) 


Preconditions.CheckNotNull(source, nameof(source)); 
Preconditions.CheckNotNull(selector, nameof(selector)); 
return SelectIimpl(source, selector); 


IEnumerable<TResult> SelectImpl( 
IEnumerable<TSource> validatedSource, 
Func<TSource, TResult> validatedSelector) 


foreach (TSource item in validatedSource) 


yield return validatedSelector(item); 


} 


这 段 代码 中 有 个 有 意思 的 地 方 己 经 加 粗 了 : 我 们 会 把 参数 传递 给 局 
部 方法 。 不 是 必须 这 么 做 ， 可 以 删除 参数 ， 然 后 让 局 部 方法 捕获 
source 和 selector 变 量 ， 但 这 么 做 可 以 性 能 提升 ， 减 少 堆 内 存 分 
配 。 这 点 性 能 提升 很 重要 吗 ? 使 用 变量 捕获 的 方式 是 耕 在 可 读 性 上 
明显 更 强 昵 ? 这 两 个 问题 都 脱 不 开 有 具体 情 况 ， 而 且 见 仁 见 智 。 




















. 可 该 性 建议 


对 我 来 说 ， 局 部 方法 还 是 很 新 的 特性 ， 使 用 时 也 会 比较 谨慎 。 我 目 
前 还 是 倾向 于 保持 代码 原样 ， 而 不 是 把 方法 重 构 为 局 部 方法 。 我 万 
其 会 避免 使 用 以 下 特性 。 


。 虽然 在 循环 或 者 其 他 代码 块 中 可 以 定义 局 部 方法 ， 但 我 觉得 这 
种 写法 看 起 来 有 扣 奇 怪 。 我 倾 回 于 只 在 答 主 方法 末尾 定义 局 部 
方法 。 我 不 会 在 循环 中 捕获 任何 变量 ,但 可 以 接受 这 种 写法 。 

。 我 不 会 尝试 在 局 部 方法 中 定义 局 部 方法 。 

当然 ， 每 个 人 都 有 目 己 的 侦 好 ， 这 一 点 毋庸 置疑 ， 但 是 我 一 员 坚 持 
不 因为 某 个 特性 可 以 使 用 便 去 使 用 。 (出 于 实验 目的 而 使 用 新 特性 
不 算 在 内 ， 但 也 尽量 不 要 因为 次 眼 的 特性 而 牺牲 代码 可 读 性 。) 


一 个 好 消 奶 是 :， 本 章 的 第 一 个 特性 最 为 庞大 ， 其 他 特性 就 简单 多 
i 





























14.2 out 变量 


在 C# 7 之 前 ，out 参 数 用 起 来 并 不 是 很 方便 。 使 用 out 参 数 时 ， 必 须 保证 
变量 在 用 作 实 参 之 前 已 提前 声明 。 由 于 变量 声明 是 一 条 独立 的 语句 ， 因 
此 这 意味 着 有 时 想 要 一 个 表达 式 〈 比 如 初始 化 变量 ) ， 最 终 需 要 多 条 语 
句 才 能 完成 。 


14.2.1 ”out 参数 的 内 联 变 量 声明 


C# 7 解决 了 这 一 痛 点 ， 它 允许 在 方法 调用 时 声明 变量 。 下 面 举 个 简单 的 
例子 。 假 设 有 一 个 接收 文本 参数 的 方法 ， 方 法 内 部 将 文本 通过 

int .TryParse 解 析 成 整 型 值 ， 最 后 返回 解析 后 的 值 ， 解 术 后 的 值 是 可 空 
的 整 型 (解析 成 功 ) 或 者 是 nul1l1 解析 失败 〉，。 如 果 使 用 C#6， 人 至 少 需 
要 两 条 语句 才能 完成 : 一 条 语句 负责 声明 变量 ， 另 一 条 语句 负 贡 调 


用 int,.TryParse 方 法 ， 并 且 把 声明 的 变量 作为 out 参 数 传 入 。 


static int? ParseInt32(string text) 


{ 





























Int Value 
return int.TryParse(text, out value) ? value : (int?) null; 


到 了 C# 7，value 变 量 就 可 以 在 方法 调用 时 进行 声明 了 ， 于 是 可 以 进 一 
步 使 用 表达 式 主体 来 实现 该 方法 : 


static int? ParseInt32(string text) => 
int.TryParse(text, out int value) ? value : (int?) null; 





out 变 量 实 参 和 模式 匹配 中 引入 的 新 变量 在 以 下 几 种 情况 下 行为 相似 。 
。 如 打 不 关心 变量 值 ， 可 以 在 变量 名 前 加 下 划 线 才 示 这 和 是 一 个 抛弃 变 


里 。 

”可 以 使 用 ar 声明 一 个 隐 式 类 型 的 变量 《通过 形 参 的 类 型 推断 共 类 
2 

。 在 表达 式 树 中 不 能 使 用 out 变 量 实 参 。 

。 变量 作用 域 局 限于 周围 的 代码 块 。 

。 在 字段 、 属 性 、 构 造 器 初始 化 器 或 者 C# 7.3 之 前 的 查询 表达 式 中 不 
能 使 用 out 变 量 ， 稍 后 会 给 出 一 个 示例 。 

。 当 且 仅 当 方法 确定 会 被 调 起 ， 该 out 变 量 才 会 是 确定 赋值 的 。 








下 面 这 段 代码 展示 了 最 后 一 条 ， 该 方法 将 两 个 字符 串 解 析 成 整 型 ， 然 后 
返回 两 个 结果 之 和 : 


static int? ParseAndSum(string text1，Sstring text2) => 
int.TryParse(text1, out int value1) && 
int.TryParse(text2, out int value2) 
? value1 + value2 : (int?) null; 


其 中 条 件 运 算 符 的 第 3 个 操作 数 valuel 是 确定 赋值 的 (因此 可 以 返回 该 
值 )， 而 value2 不 是 确定 赋值 的 。 这 是 因为 如 果 第 1 个 int.TryParse 调 用 
返回 false， 就 不 会 调用 第 2 个 int.TryParse 了 ，&& 运 算 符 的 短路 属性 使 
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14.2.2 C# 7.3 关 于 out 变 量 和 模式 变量 解除 的 限制 


12.5 节 讲 过 ， 初 始 化 字段 或 者 属性 时 不 能 使 用 模式 变量 ， 在 构造 初始 化 
器 (this(...) 和 base(....)) 或 者 查询 表达 式 时 也 不 能 使 用 。 对 于 out 
变量 ， 这 些 限制 同样 存在 ， 不 过 C# 7.3 解 除了 这 些 限 制 。 代 码 清单 14-10 
中 的 out 变 量 的 结果 在 构造 器 体 中 也 可 以 访问 。 


代码 清单 14-10 ”在 构造 器 初始 化 右 中 使 用 out 变 量 


class ParsedText 








public string Text { get; } 
public bool Valid { get,; } 


protected ParsedText(string text, bool valid) 


Text = text,; 
Valid = valid; 


} 
class ParsedInt32 : ParsedText 
public int? Value { get,; } 


public ParsedInt32(string text) 
: base(text, int.TryParse(text, out int parseResult)) 


Value = Valid ? parseResult : (int?) null; 


} 


尽管 C# 7.3 之 前 的 那些 限制 从 未 对 我 造成 影响 ， 但 移 除 这 些 限制 依然 是 
好 事 一 桩 。 对 于 需要 在 初始 化 颖 中 使 用 模式 或 者 out 变 量 的 极 少 数 情 
况 ， 解 决 起 来 会 很 麻烦 ， 通 常 需 要 创建 一 个 新 方法 。 


以 上 就 是 关于 out 变 量 实 参 的 全 部 内 容 ， 该 特性 主要 用 于 避免 额外 的 变 
量 声明 语句 。 


14.3 ”数字 字面 量 的 改进 


在 C# 的 演化 历史 中 ， 字 面 量 通常 不 会 发 生 太 大 变化 ， 从 C# 1 到 C# 6 没有 
任何 变动 ， 虽 然 其 间 引 入 了 内 揪 字 符 串 字面 量 ， 但 是 该 特性 不 涉及 数字 
字面 量 。C# 7 引入 了 两 个 关于 数字 字面 量 的 特性 ， 二 者 都 则 在 增强 代码 
可 读 性 ， 分 别 是 二 进 制 整 型 字面 量 和 下 划 线 分 隔 符 。 














14.3.1 二进制 整 型 字面 量 


与 浮 点 型 字面 量 (float、double 和 decimal) 不 同 ， 整 型 字面 量 的 字面 
量 有 两 种 表示 方式 : 十 进 制 (没有 前 级 ) 或 者 十 六 进 制 ( 使 用 ox 或 者 ox 
前 级 ) 。C# 7 将 其 进一步 扩展 ， 增 加 了 二 进 制 字 面 量 ， 使 用 ob 或 者 6B 为 
前 缀 4。 这 对 于 那些 针对 特定 值 需要 制定 特殊 位 模式 的 协议 来 说 非常 有 
用 。 新 的 二 进 制 字面 量 完 全 不 会 影响 执行 期 的 行为 ， 但 能 让 代码 更 易 
读 。 例 如 下 面 3 个 变量 值 ， 知 要 表示 字 节 的 第 1 位 和 后 3 位 是 1， 其 他 位 是 
0， 哪 种 方式 更 直观 呢 ? 


4C# 设 计 团 队 很 明智 地 避 开 了 Java 继 承 自 C 语 言 的 八进制 字面 量 。 比 如 
011 的 值 是 多 少 ， 并 不 显而易见 。 











byte bi = 135; 
byte b2 = Ox83; 
byte b3 = 0b10000111; 


这 3 个 变量 值 相同 ， 但 是 第 3 个 声明 更 清楚 明了 。 不 过 即便 采用 第 3 种 声 
J 也 需要 花 一 点 时 间 来 核对 位 数 是 否 正 确 ， 那 有 没有 更 清楚 的 表 
ve 


14.3.2 下划线 分 隔 符 








下 面 使 用 下 划 线 分 隔 符 解决 上 面 的 问题 。 如 果 想 识别 一 个 字 节 内 的 所 有 
位 ， 把 8 个 位 分 割 成 两 部 分 会 更 清晰 明 了。 下面 这 段 代 码 在 前 面 代码 的 
基础 上 增加 了 第 4 行 ， 使 用 下 划 线 分 隔 符 划 分 了 位 。 


byte bi = 135 
byte b2 = 0X83 
byte b3 = 0b10000111;， 
byte b4 = 0b1000 0111; 


效果 很 好 ， 一 目 了 然 。 下 划 线 分 隔 符 不 仅 能 用 于 二 进 制 字 面 量 ， 也 能 
于 整 型 字面 量 。 在 任何 数字 字面 量 的 任何 位 置 ， 都 可 以 使 用 下 划 线 分 隔 
符 。 在 十 进 制 字 面 量 中 ， 一 般 每 3 个 数字 惑 分 制 ， 如 同 千 分 符 那 样 〈 按 
0 
8、16 和 32 位 。 








int maxInt32 = 2 147_483_ 647 

decimal largeSalary = 123_456_789.12m; 

ulong alternatingBytes = Oxff_00_ff_00_ ff_00_ff_00; 
ulong alternatingwords = Oxffff_0000_ffff_0000; 
ulong alternatingDwords = Oxffffffff_00000000; 


这 种 灵活 性 也 带 来 一 个 问题 : 编译 露 是 不 会 帮忙 检查 下 划 线 是 售 放 在 了 
有 效 的 位 置 ， 比 如 多 个 下 划 线 连 写 。 下 面 这 两 种 写法 虽然 合法 ， 但 是 没 
有 实际 意义 。 


int wideFifteen = 1 5 ， 
ulong notQuiteAlternatingwords = Oxffff_000_ffff_0000; 


另外 ， 还 有 几 项 限制 需要 知悉 : 


下 划 线 不 能 出 现在 字面 量 的 开始 ; 

下 划 线 不 能 出 现在 字面 量 的 末尾 (包括 后 级 前 面 〉; 

浮 点 型 字面 量 小 数 点 前 后 不 能 有 下 划 线 ; 

在 C# 7.0 和 C# 7.1 中 ， 整 型 字面 量 的 数 基 (ex 或 68) 后 不 能 出 现下 
划 线 。 


C# 7.2 取 消 了 最 后 一 项 限制 。 虽 然 可 读 性 属于 主观 感受 ， 但 如 果 字 面 量 
中 有 下 划 线 ， 我 往往 会 在 数 基 符 之 后 也 添加 下 划 线 ， 例 如 : 


























e Ob 1000 0111 versus 0b1000 0111 
ee 0x ffff 0000 versus 0xffff 0000 





天 于 数字 字面 量 就 这 么 多 内 容 。 这 个 特性 简单 友好 ， 没 有 什么 珊 雁 难 
扩 。 下 一 个 特性 也 与 之 类 似 : 在 茶 些 情况 下 ， 当 需要 根据 条 件 抛 出 异常 
时 ， 可 以 简化 代码 。 


14.4 throw 表达 式 


C# 早 先 版 本 就 有 throw 语 句 ， 但 throw 语 句 不 能 用 作 表 达 式 ， 因 为 基本 不 
需要 这 么 做 一 一 throw 总 会 抛 出 异常 。 越 来 越 多 的 新 特性 需要 表达 式 的 
支持 ， 这 种 分 类 显然 落伍 了 。 在 C# 7 中 可 以 使 用 throw 表 达 式 ， 不 过 仅 
限于 以 下 几 种 场景 : 


。 作为 lambda 表达 式 的 主体 ; 

。 用 作 表 达 式 主体 成 员 ; 

。 ?? 运 算 符 的 第 2 个 操作 数 ; 

。 条 件 运 算 符 ?: 的 第 2 个 或 者 第 3 个 操作 数 〈 但 不 能 同时 出 现在 同一 个 
表达 式 中 ) 。 


以 下 代码 均 合 法 : 


public void UnimplementedMethod() => (本 行 及 以 下 1 行 ) 表达 式 主体 方法 
throw new NotImplementedException(); 

















public void TestPredicateNeverCalledOonEmptySequence() 


int count = new string[0] 
.Count(x => throw new Exception("Bang!")); <------ lambda 
ASssert .AreEdual(0，count ) ; 


public static T CheckNotNull<T>(T value, string paramName) where 
=> Value ?? (本 行 及 以 下 1 行 ) ?? 运 算 符 〔 在 表达 式 主体 方法 内 部 ) 
throw new ArgumentNullException(paramName); 














public static Name => (本 行 及 以 下 3 行 ) ?: 运 算 符 ( 在 表达 式 属性 内 部 ) 
initialized 
? data["name"] 
: throw new Exception("..."); 


当然 ，throw 表 达 式 也 不 能 随处 使 用 ， 因 为 很 多 时 候 没 有 实际 意义 ， 例 
如 不 能 用 于 无 条 件 赋 值 语句 ， 或 者 用 作 方 法 实 参 : 





int invalid = throw new Exception("This would make no sense"); 
Console.writeLine(throw new Exception("Nor would this")); 


C# 设 计 团 队 为 throw 表 达 式 赋予 了 应 有 的 灵活 性 (尤其 是 可 以 以 更 精准 
I 逻辑 ) ， 同 时 避免 了 由 于 滥用 throw 表 达 式 而 造 
成 麻烦 


下 二 特性 也 是 以 更 简洁 的 方式 表达 同样 的 远 罗 辑 : 使 用 默认 字面 量 的 
default 运 算 符 。 


14.5” default 字面 量 (C#7.1) 


default(T) 是 C# 2.0 引 入 的 特性 ， 它 主要 是 为 泛 型 服务 的 。 例如 利用 索 
人 人 如 果 索 引 超 出 列表 范围 ， 那 么 返回 该 类 型 的 默认 
尺码 如 下 


static T GetValueOrDefault<T>(IList<T> list, int index) 
{ 


return index >= 0 && index < list.Count ? list[index|] : defau 


default 运 算 符 的 结果 和 一 个 未 初始 化 的 字段 的 默认 值 相 同 : 如 果 是 引 
用 类 型 ， 那么 是 nu11 引 用 ; 如 果 是 数值 类 型 ， 就 是 相应 的 0 值 ， 例 如 
char 类 型 的 U+0000，bool 类 型 的 false， 以 及 其 他 值 类 型 的 对 应 默认 
值 。 


在 C# 4 引入 可 选 形 参 之 后 ， 为 形 参 指 定 默 认 值 的 一 种 方式 就 是 使 

用 default 运 算 符 ; 但 是 如 琳 类 型 名 称 很 长 ， 这 种 写法 就 很 笨拙 了 ， 
为 最 后 类 型 名 称 会 出 现在 形 参 类 型 和 默认 值 这 两 处 。 其 中 最 糟糕 的 一 个 
例子 是 cancellationToken， 特 别 是 该 类 型 的 参数 名 称 习 惯性 地 都 

是 cancellationToken。 季 见 的 async 方 法 签名 如 下 : 





public async Task<string> FetchValueAsync( 
string key, 
CancellationToken cancellationToken = default(CancellationTok 


其 中 第 2 行 的 参数 就 有 64 个 字符 之 多 ， 以 至 于 还 需要 单独 的 一 行 空 间 。 


到 了 C# 7.1， 在 某 些 上 下 文中 ， 可 以 使 用 default 而 不 是 default(T)， 人 然 
后 由 编译 器 来 判断 应 该 使 用 哪个 类 型 。 虽 然 该 特性 所 带 来 的 好 处 远 不 止 


于 此 ， 但 这 是 推出 该 特性 的 最 主要 动机 之 一 。 上 述 代 码 可 以 简化 为 : 


public async Task<string> FetchValueAsync( 
string key, CancellationToken cancellationToken = default) 


这 样 就 简洁 多 了 。 由 于 省 略 了 类 型 名 称 ， 此 时 的 default 变 成 了 一 个 字 
面 量 ， 而 不 是 运算 待 ， 其 行为 方式 与 nul1 字 面 量 类 似 ， 只 不 过 default 
字面 量 对 于 所 有 类 型 都 适用 。default 字 面 量 本 身 没 有 类 型 ， 就 像 nul1 
字面 量 没有 类 型 一 样 ， 但 是 它 可 以 转换 成 任何 类 型 ， 而 转换 的 目标 类 型 
可 能 是 从 别处 推断 出 来 的 ， 束 像 隐 式 类 型 的 数组 一 样 : 


Var intArray = new[|] { default, 5 }; 
Var stringArray = new[] { default, "text" }; 


这 段 代 码 中 没有 出 现任 何 类 型 名 称 ，intArray 是 一 个 隐 式 的 int[] 
(Cdefault 字 面 量 被 转换 成 了 0) ，stringArray 是 一 个 隐 式 的 string[] 
Cdefault 字 面 量 被 转换 成 了 nul11 引 用 ) 。 和 null 字 面 量 一 样 ， 上 下 文中 
必须 至 少 出 现 一 个 类 型 ， 以 便 编 译 吉 推 新 类 型 : 


var Invalid = default,; 
var alsoInvalid = new[] { default }; 


如 果 default 字 面 量 转换 后 的 类 型 不 是 引用 类 型 或 者 原生 类 型 ， 它 会 被 
当 作 一 个 常量 表达 式 ， 可 以 用 于 attribute 中 。 


有 一 个 奇怪 的 问题 需要 注意 ，default 具 有 多 重 含义 。 它 可 以 表示 某 个 
类 型 的 默认 值 ， 也 可 以 表示 茶 个 可 选 形 参 的 默认 值 ， 而 default 字 面 量 
永远 指 癌 对 应 类 型 的 默认 值 。 例 如 茶 个 提供 了 默认 值 的 可 选 形 参 ， 在 方 





























法 调用 时 使 用 default 作 为 实 参 ， 就 会 让 人 很 迷惑 。 思 考 以 下 代码 。 
代码 清单 14-11 将 default 字 面 量 用 作 方 法 实 参 
static void PrintValue(int value = 10) <------ 形 参 的 默认 值 是 10 





Console.WriteLine(value); 


static void Main() 








PrintValue(default); <------ 使 用 int 默 认 值 作为 方法 实 参 





这 段 代码 的 执行 结果 是 0， 因 为 0 是 int 类 型 的 默认 值 。 虽 然 语言 层面 上 
讲 ， 它 是 自 洽 和 一 致 的 ， 但 是 由 于 default 的 多 义 性 ， 在 实际 代码 中 仍 
会 造成 混 消 。 对 于 这 种 情况 ， 应 尽量 避免 使 用 default 字 面 量 。 


14.6 ” 非 尾部 命名 实 参 


可 选 形 参 和 命名 实 参 是 C# 4 的 两 个 补充 特性 。 这 两 个 特性 都 对 参数 顺序 
有 要 求 ， 可 选 形 参 必须 出 现在 所 有 必要 形 参 之 后 〈 形 参数 组 除外 ) ， 命 
名 实 参 必须 出 现在 所 有 定位 实 参 之 后 。 a 
不 过 他 们 发 现 命名 实 参 在 提升 表意 清晰 度 上 大 有 可 为 。 当 实 参 是 字面 量 
《特别 是 数字 、 布 尔 值 或 者 nul1) 时 ， 使 用 命 名 实 参 的 作用 会 区 为 突 

出 ， 因 为 字面 量 体 现 不 出 参数 值 的 含义 。 


我 为 BigQuery 客 户 端 库 编 写 过 一 些 示例 。 在 同 BigQuery 上 传 某 个 CSV 文 
件 时 ， 可 以 由 用 户 指定 一 个 schema， 也 可 以 让 服务 器 来 选择 schema， 或 
者 从 表 中 读 取 schema。 在 编写 上 自动 检测 的 示例 代码 时 ，schema 参 数 应 当 
可 以 传递 nul1 引 用 。 例 如 下 面 的 代码 ， 简 单 但 不 够 清晰 ， 因 为 nul1 实 参 
的 含义 并 不 明确 : 


client.UploadCsv(table, null, csvData, options); 


在 C# 7.2 中 ， 要 么 后 3 个 参数 都 使 用 命名 实 参 (最 终 代 码 看 起 来 会 比较 奇 
怪 ) ， 要 么 如 下 所 示 声 明 一 个 解释 性 的 局 部 变量 : 


TableSchema Schema = null; 
client.UploadCsv(table, schema, csvData, options); 


里 然 意 图 表达 浓 晰 卫 ; 但 还 不 够 完美 。C# 7.2 取 消 了 命名 实 参 的 位 置 限 
制 ， 可 以 直接 采用 命名 实 参 的 方式 来 调用 ， 而 不 需要 一 条 额外 的 语句 
了 : 


client.UploadCsv(table, schema: null, csvData, options); 


对 于 在 多 个 重 载 方法 中 实 参 (特别 是 nul1) 会 被 转换 成 同一 个 形 参 位 置 
的 情况 ， 该 特性 有 助 于 区 分 这 些 重 载 方法 。 


非 尾部 命名 实 参 的 使 用 规则 经 过 认真 的 设计 ， 以 此 避免 定位 实 参 出 现 二 
义 性 : 如 果 命 名 实 参 后 面 出 现 了 未 命名 实 参 ， 那 么 应 把 命名 实 参 当 作 普 



































通 定位 实 参 ， 例 如 以 下 方法 声明 及 其 3 个 调用 : 


void M(int x, int y, int z){} 











M(5, Zz: 15, y: 10); <------ 合法 : 尾部 命名 实 参 可 以 打 乱 顺序 
M(5, y: 10, 15); <------ 合法 : 非 尾部 命名 实 参 保持 顺序 
M(y: 10, 5, 15); <------ 非法 : 非 尾 部 命名 实 参 没有 保持 顺序 





第 1 个 调用 是 合法 的 ， 因 为 它 只 有 一 个 定位 实 参 ， 后 跟 两 个 命名 实 参 。 
显然 ， 定 位 实 参 对 应 的 是 形 参 x， 另 外 两 个 可 以 根据 名 字 分 别 对 应 ， 因 
此 没有 二 义 性 。 


第 2 个 调用 是 合法 的 ， 因 为 即便 命名 实 参 后 面 有 定位 实 参 ， 但 命名 实 参 
所 对 应 的 形 参 和 它 作 为 定位 实 参 对 应 的 形 参 是 一 致 的 ， 都 是 y。 因 此 该 
调用 还 是 能 够 明确 参数 之 间 的 对 应 关系 。 


但 是 第 3 个 调用 是 非法 的 : 第 1 个 实 参 是 命名 实 参 ， 它 对 应 的 形 参 是 y， 
那么 第 2 个 实 参 应 该 对 应 第 一 个 x 吗 ? 因为 这 是 第 一 个 未 命名 的 实 参 。 即 
便 可 以 按照 这 种 方式 进行 对 应 ， 也 会 造成 一 定 程度 的 混淆 ; 如 果 有 可 选 
形 参 ， 情 况 就 更 糟 了 。 更 简单 的 做 法 是 直接 禁止 ， 这 也 是 C# 设 计 团 队 的 
最 终 决 定 。 接 下 来 要 介绍 的 特性 一 直 存 在 于 CLR 中 ， 但 是 直到 C# 7.2 才 
在 语言 层面 对 外 提供 。 


14.7 ”私有 受 保护 的 访问 权限 (C# 7.2) 


几 年 前 《甚至 可 能 更 早 ) C# 6 准备 引入 private protected， 但 苦于 命 
问题 。 直 到 C# 7.2，C# 设 计 团 队 才 最 终 决定 还 是 保持 private 
protected, 因为 找 不 到 更 适合 的 名 字 。 private 和 protected 结 合 比 任意 
一 个 单独 修饰 符 的 限制 都 要 强 。 只 有 在 同一 程序 集中 并 且 继 承 该 类 的 代 
人 码 ， 才 能 访问 private protected 的 成 员 。 












































与 之 相对 的 是 protected internal, 该 修饰 符 比 protected 或 者 internal 
单独 的 限制 都 要 弱 。 一 个 protected internal 成 员 ， 处 于 同一 程序 集 的 
代码 或 者 位 于 其 子 类 《或 当前 类 ) 的 代码 都 可 以 访问 它 。 


天 于 这 项 特性 ， 了 解 这 些 即 可 ， 甚 全 不 需要 示例 。 从 语言 完整 性 的 角度 
来 看 ， 该 特性 完成 了 它 的 使 命 : 该 访问 级 别 既 存在 于 CLR， 也 存在 于 C# 
中 。 这 项 特性 我 只 用 过 一 次 ， 将 来 它 也 不 大 可 能 变 得 特别 有 用 。 本 章 最 











后 介绍 一 些 零碎 的 、 不 太 好 归 类 的 特性 。 
14.8 ”CC#7.3 的 一 些小 改进 


从 之 前 的 内 容 不 难看 出 ， 在 C# 7.0 推 出 之 后 ，C# 设 计 团 队 依然 在 不 遗 余 
力 地 改进 语言 ， 其 中 大 部 分 是 增强 C# 7.0 主 要 特性 的 一 些小 特性 。 本 书 
在 描述 这 些 主要 特性 时 ， 都 尽 可 能 地 把 相关 小 特性 一 起 介绍 了 ， 不 过 C# 
Re 而 且 它 们 也 不 太 符 合 本 章 主题 ， 不 过 不 应 遗 

漏 它们 。 


14.8.1 泛 型 类 型 约束 


2.1.5 节 讲 类 型 约束 时 ， 实 际 有 一 些 约束 没有 提 到 。 在 C# 7.3 之 前 ， 类 型 
约束 不 能 要 求 某 个 实 参 必须 继承 自 Enum 或 者 Delegate。C# 7.3 解 除了 这 
两 项 限制 ， 同 时 增加 了 新 的 约束 类 型 : unmanaged 约 束 。 代 人 码 清单 14-12 
展示 了 如 何 指定 和 使 用 这 些 约束 。 


代码 清单 14-12”C# 7.3 中 的 新 约束 


enum SampleEnum {} 

static void EnumMethod<T>() where T : struct, Enum {} 
static void DelegateMethod<T>() where T : Delegate {} 
static void UnmanagedMethod<T>() where T : unmanaged {} 





EnumMethod<SampleEnum>(); <------ 合法 : 枚 举 值 类 型 
EnumMethod<Enum>(); <------ 非法 : 不 符合 struct 类 型 约束 








DelegateMethod<Action>(); 
DelegateMethod<Delegate>(); (本 行 及 以 下 1 行 ) 均 为 合法 代码 
DelegateMethod<MulticastDelegate>(); 














UnmanagedMethod<int>(); <------ 合法 : System,Int32 是 非 托 管 类 型 
UnmanagedMethod<string>(); <------ 非法 : System.String 是 托管 类 型 








对 于 enum 约 束 ， 上 面 的 例子 使 用 的 是 where T : struct，Enum， 因 为 这 
个 形式 更 常用 。 这 样 就 把 类 型 r 限 制 到 了 一 个 真正 的 枚 举 类 型 上 : 一 个 
继承 自 Enum 的 值 类 型 。 其 中 的 struct 约 束 条 件 将 Enum 类 型 本 身 排 除 在 
外 。 如 果 想 编写 一 个 可 以 操作 任意 枚 举 类 型 的 方法 ， 通 常 不 需要 处 
理 Enum 类 型 本 身 ， 因 为 Enum 类 型 不 是 枚 举 类 型 。 然 而 该 特性 推出 得 实在 
太 晚 了 ，framewotk 中 负责 解析 枚 举 类 型 的 那些 方法 已 经 无 法 应 用 它 





JT 


delegate 约 束 并 没有 类 似 的 要 求 ， 因 此 无 法 表达 “必须 是 使 用 委托 声明 
的 类 型 > 这 样 的 约束 。 可 以 使 用 where T: MulticastDelegate 这 样 的 约 
束 ， 但 MulticastDelegate 这 个 类 型 本 身 依 然 可 以 用 作 类 型 实 参 。 


最 后 一 个 新 增 约束 是 unmanaged 类 型 ， 前 面 提 到 过 一 次 ， 非 托管 的 类 型 
是 非 可 空 、 非 泛 型 的 值 类 型 ， 而 且 其 字段 也 不 能 是 引用 类 型 ， 以 此 类 
推 。framework 中 的 大 部 分 值 类 型 (Int32、Double、Decimal、Guid) 是 
韭 托 管 类 型 ， 而 类 似 于 Noda Time 项 目 中 的 ZonedpateTime 类 型 是 典型 的 
托管 类 型 ， 因 为 它 包 含 了 对 DateTimezone 实 例 的 引用 。 


14.8.2” 重 载 雇 议 改进 

重 载 决议 的 策略 一 直 在 变化 ， 通 常 很 难 简 单 地 解释 清楚 ， 但 C# 7.3 的 这 
次 改动 是 个 例外 : 曾经 需要 在 重 载 决 议 完 成 之 后 检查 的 几 个 条 件 都 被 提 
前 了 ， 于 是 以 前 C# 版 本 中 某 些 被 认为 有 区 义 或 者 非法 的 情况 现在 变 得 合 
法 了 。 其 中 共 涉 及 以 下 几 项 检查 : 

e。 泛 型 类 型 实 参 必 须 符 合 类 型 形 参 的 全 部 类 型 约束 ; 

。 静态 方法 不 能 按照 实例 方法 的 方式 调用 ; 

。 实例 方法 不 能 按照 静态 方法 的 方式 调用 。 

第 一 种 情况 举例 ， 考 虑 如 下 重 载 方法 : 


static void Method<T>(object x) where T : Struct => <------ 具有 st 
Console.writeLine($"{typeof(T)} is a struct"); 























static void Method<T>(string x) where T : class => <------ 具有 cla 
Console.writeLine($"{typeof(T)} is a reference type"); 


Method<int>("text"); 
在 以 前 的 C# 版 本 中 ， 重 载 决议 在 开始 时 会 忽略 类 型 形 参 的 约束 条 件 ， 于 


是 第 2 个 方法 可 能 会 被 选中 ， 因为 string 类 型 比 obpject 类 型 更 具体 ,之 
后 才 会 发 现 类 型 实 参 int 并 不 符合 类 型 约束 的 条 件 。 


在 C# 7.3 中 ， 这 段 代 码 可 以 通过 编译 ， 也 没有 二 义 性 了 ， 因 为 在 查找 合 
适 方法 时 会 检查 类 型 约束 。 另 外 两 项 检查 与 之 类 似 : 编译 占 会 抛弃 不 符 





合 要 求 的 方法 ， 这 一 过 程 比 之 前 要 进行 得 早 。 随 书 代码 中 包含 以 上 3 种 
情况 的 例子 。 


14.8.3 ”字段 的 attribute 支 持 自动 实现 的 属性 


假设 有 一 个 字段 的 简单 属性 ， 需 要 对 该 字段 应 用 一 个 attribute， 以 支持 
其 他 基础 架构 。 在 C#7.3 以 前 ， 需 要 单独 声明 该 字段 ， 然 后 使 用 样板 代 
码 编写 一 个 属性 。 如 果 想 对 某 个 string 类 型 的 属性 应 

用 DemoAttribute〈 虚 构 的 ) ， 那 么 代码 如 下 : 

[Demo ] 


private string name ; 
public string Name 








get { return name; } 
set { name = value; } 


} 


有 了 目 动 实现 的 属性 之 后 ， 束 可 以 省 去 一 些 不 必要 的 样板 代码 。 到 了 C# 
7.3， 还 可 以 进一步 对 自动 实现 的 属性 应 用 attribute: 


[field: Demol 
public string Name { get; Set } 


这 里 的 field 并 不 是 attribute 的 新 修饰 符 ， 只 是 以 前 它 不 能 用 于 此 类 上 下 
文 而 已 。( 至 少 不 是 官方 许可 的 ， 不 适用 微软 的 编译 器 ，Mono 编 译 器 
己 支 持 这 种 写法 。) 这 算是 语言 规范 中 不 一 致 的 一 种 体现 ，C# 7.3 把 它 
7 


14.9 小结 


局 部 方法 可 用 于 清晰 地 表达 特定 代码 块 是 某 个 操作 的 实现 细 市 ， 而 
不 是 类 型 本 映 的 东 种 通用 操作 。 

out 变 量 属于 削减 形式 代码 的 特性 ， 这 样 茶 些 多 条 语句 〈 声 明 并 使 
用 一 个 变量 ) 可 以 精简 为 一 条 语句 。 

二 进 制 字面 量 表示 整 型 值 时 可 以 更 清晰 ， 但 是 其 中 位 的 模式 比 数值 
的 大 小 更 重要 。 

在 有 了 数位 分 隔 符 之 后 ， 数 位 较 多 的 字面 量变 得 易 读 了 。 

与 out 变 量 类 似 ，throw 表 达 式 使 得 以 往 需要 多 条 语句 才能 完成 的 多 

















辑 缩减 到 了 一 条 。 

。 default 字 面 量 可 以 消除 代码 见 余 ， 也 可 以 避免 重复 编码 。 

。 与 其 他 特性 不 同 ， 使 用 非 尾部 命名 实 参 并 不 能 减少 代码 量 ， 但 是 可 
以 提升 表意 清晰 度 。 假 如 有 很 多 现 有 的 命名 实 参 ， 只 希望 给 中 间 茶 
个 实 参 命 名 ， 那 么 可 以 做 到 既 削 减 代码 量 ， 又 表意 清晰 。 








第 15 章 C#8 及 其 后 续 


本 章 内 容 概览 


引用 类 型 表达 nu11 值 与 非 nu11 值 预期 ; 
switch 语 句 与 模式 匹配 ; 
属性 递归 模式 匹配 ; 

使 用 index 和 range 语 法 编写 简洁 一 致 的 代码 ; 
using、foreach 和 和 yield 语句 的 异步 版 本 。 


在 本 书 编写 之 时 ，C# 8 还 处 于 设计 阶段 。C# 的 GitHub 的 代码 库 中 有 很 多 
潜藏 的 特性 ， 但 只 有 其 中 一 小 部 分 特性 公开 了 编译 器 的 预览 构建 版 本 。 
本 章 只 是 针对 C# 8 做 一 些 合理 的 猜测 ， 所 讨论 的 内 容 都 尚未 成 定论 。 这 
些 特性 应 该 不 会 全 都 出 现在 C# 8 中 ， 因 此 本 章 只 讨论 我 认为 C# 8 中 可 能 
推出 的 特性 ;尽管 涵盖 了 预览 版 本 中 可 用 特性 的 大 部 分 细节 ， 但 这 些 内 
容 未 来 有 可 能 发 生变 化 。 


说 明 “就 在 本 章 编写 之 时 ， 预 览 版 的 构建 中 只 有 C# 8 的 几 个 特性 ， 
并 且 不 同 的 特性 对 应 了 不 同 版 本 的 构建 。 其 中 可 空 引用 类 型 只 支持 
纯 .NET 工 程 (不 支持 .NET Core SDK 风 格 的 工程 ) 。 如 果 读 者 的 工 
程 使 用 新 的 工程 格式 ， 那 么 尝试 这 些 新 特性 的 实验 会 比较 困难 。 在 
站 
孚 除了 ) 。 


首先 介绍 可 空 引 用 类 型 。 

15.1 可 空 引 用 类 型 

nul1 引 用 ， 束 是 Tony Hoare 在 2009 年 为 他 在 20 世 纪 60 年 代 引 入 它 臻 菊 时 
所 说 的 “十 亿美 金 的 过 失 ”。 经 验 丰 宇 的 C# 程 序 员 基本 都 吃 过 
NulL1LReferenceException 的 兰 头 。C# 设 计 团 队 为 “驯服 ”nul11 引 用 这 头 “ 野 
兽 ? 制 定 了 周详 的 计划 ， 对 nul11 引 用 应 当 出 现 的 位 置 做 了 清晰 的 解释 。 


15.1.1 可 空 引 用 类 型 可 以 解决 什么 问题 

















代码 清单 15-1 展 示 的 例子 会 贯穿 本 节 。 如 采 读 者 查看 随 附 的 源码 ， 就 会 
发 现 我 为 每 个 例子 都 声明 了 独立 的 巷 套 类 。 


代码 清单 15-1  C# 8 之 前 的 原始 模型 
public class Customer 
public string Name { get; set,; } 


public Address Address { get; set; } 
} 


public class Address 


public string Country { get; set; } 


一 般 来 说 ， 地 址 信息 中 包含 的 字段 肯定 个 止 country， 不 过 这 一 个 属性 
对 于 本 章 来 说 已 经 足够 了 。 使 用 这 两 个 类 定义 ， 代 码 的 安全 性 如 何 呢 ? 


Customer customer = ， 
Console. We Address.Country); 


如 果 我 们 确定 customer 是 非 空 对 象 ， 且 每 个 customer 都 有 一 个 关联 的 
address， 那 么 没有 问题 ， 但 如 何 才能 确定 呢 ? 如 果 只 是 因为 文档 做 了 标 
注 ， 怎 么 才能 把 这 上 段 代码 变 得 更 安全 呢 ? 

从 C# 2 开始 就 有 了 可 空 值 类 型 、 非 可 空 值 类 型 ， 以 及 隐 式 可 空 引 用 类 
型 。 由 可 衬 / 非 可 空 、 值 类 型 /引用 类 型 两 两 组 合成 的 表格 就 只 差 最 后 一 
个 可 引用 类 型 还 空缺 ， 见 表 15-1。 


表 15-1 C#7 对 于 可 空 和 非 可 空 、 引 用 类 型 和 值 类 型 的 支持 
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目前 第 2 个 单元 格 尚 未 文 持 ， 这 就 意味 痢 无 法 表达 “有 些 引 用 值 可 能 

是 nul1， 而 有 些 引用 值 不 可 能 是 nul11” 这 样 的 意图 。 当 代码 运行 时 遇 到 
意外 的 nul1 值 ， 很 难 碍 找 出 问题 究竟 出 在 哪 块 代码 ， 除 非 代 码 文档 详尽 
并 且 有 贯穿 始终 的 nul1 检 查 措 施 1。 


1 就 在 写 下 这 段 话 的 前 一 天 ， 我 还 花 了 大 量 时 间 追 踪 这 个 问题 ， 确 实 是 
非常 现实 的 困扰 。 
鉴于 现在 有 大 量 .NET 代 码 不 支持 以 机 器 可 读 的 方式 来 区 分 可 空 引用 和 非 


可 空 引 用 ， 因 此 对 于 可 空 引用 的 设计 需要 格外 谨慎 。 那 么 究竟 该 如 何 实 
现 呢 ? 


15.1.2 ”在 使 用 引用 类 型 时 改变 其 含 》 

设计 空 值 安 全 特性 的 普遍 的 思路 是 ， 假 定 开 发 人 员 在 没有 刻意 区 分 引用 
类 型 可 空 或 非 可 空 时 ， 默 认为 非 可 空 。 对 于 可 空 引用 类 型 ，C# 语 言 引入 
了 新 语法 : string 是 非 可 空 引 用 类 型 ， 而 string? 是 可 空 引 用 类 型 ， 于 
是 表 15-1 就 变 成 了 表 15-2。 


表 15-2 C# 8 对 于 引用 类 型 和 值 类 型 可 空 与 非 可 空 的 支持 
































缺少 CLR 类 型 表示 。 使 用 ?后 | 当 可 空 引 用 类 型 的 支持 激 


级 作为 可 空 标记 活 时 的 默认 值 


NulLLable<T> 或 ?后 绥 





这 样 的 设计 看 起 来 很 不 严谨 。 它 改变 了 现 有 C# 代 码 中 所 有 涉及 引用 类 型 
的 含义 ! 如 果 激 活 了 该 特性 ， 将 意味 着 所 有 引用 类 型 的 默认 值 将 从 可 空 
变 为 非 可 空 。 该 设计 的 前 提 是 假定 nu11 引 用 出 现 的 次 数 应 当 远 少 于 null 








引用 不 应 出 现 的 次 数 。 


回 到 前 面 customer 和 address 的 例子 。 如 果 保 持原 有 代码 不 变 ， 编 译 器 将 
发 出 警告 ， 因 为 customer 和 Address 类 人 允许 非 可 空 属性 不 经 初始 化 即 可 使 
用 。 我 们 可 以 使 用 参数 韭 可 空 的 构造 占 来 解决 这 个 问题 ， 见 代码 清单 
15-2。 


代码 清单 15-2 全 部 改换 成 非 可 空 届 性 的 模型 
public class Customer 


public string Name { get; set; } 
public Address Address { get; set; } 


public Customer(string name, Address address) => 
(Name, Address) = (name, address); 


} 
public class Address 
public string Country { get; set; } 


public Address(string country) => 
Country = country,; 


} 


这 时 “不 能 ”在 不 提供 非 空 name 和 非 空 address 的 情况 下 构建 customer 实 例 
了 ， 也 “不 能 ”在 不 提供 非 空 country 的 情况 下 构建 Address 实 例 了 。 对 于 
这 里 “不 能 2 加 引号 的 原因 ，15.1.4 节 会 解释 。 


且慢 ， 考 虑 向 终端 输出 结果 的 这 部 分 代码 : 


Customer customer = ， 
Console. Wr el et oe Address.Country); 


这 上 段 代 人 码 是 安全 的 ， 前 提 是 每 一 部 分 都 遵守 了 前 面 的 约定 。 这 上段 代码 不 
仅 不 会 抛 出 异常 ， 而 且 我 们 也 不 可 能 给 console.writeLine 传 入 nul1 值 ， 
为 address 的 country 属 性 不 可 能 为 nul1。 


这 样 编译 器 就 能 做 nul1 值 检查 了 ， 但 如 果 需 要 允许 nul1 值 呢 ? 下 面 介绍 
刚刚 提 到 的 新 语法 。 


15.1.3 ”输入 可 空 引 用 类 型 


用 于 表示 可 空 引 用 类 型 的 语法 想必 读者 已 不 陌生 。 它 和 可 空 值 类 型 相 
同 : 在 类 型 名 称 后 面 添加 一 个 问号 。 在 引用 类 型 出 现 的 地 方 ， 大 都 可 以 
使 用 该 符号 ， 例 如 下 面 这 个 方法 : 


string FirstOrSecond(string? first, string second) => 
first ?7? second; 


这 段 代 码 提 供 了 如 下 信息 : 
。 first 是 可 空 string 类 型 ; 
。 second 是 非 可 空 string 类 型 ; 
® 返回 类 型 是 非 可 空 string 类 型 。 

如 果 误 用 了 null 值 ， 编 译 器 就 会 发 出 警告 ， 例 如 : 
。 将 可 能 为 nu1l 的 值 赋 给 非 可 空 的 变量 或 属性 ; 
。 将 可 能 为 nul1 的 值 作为 非 可 空 形 参 的 实 参 ; 
。 解 引用 可 能 为 nul1 的 值 。 


我 们 以 此 为 基础 重新 设计 前 面 的 customer 模 型 。 首 先 假设 address 可 以 
为 nul1l1， 那 么 需要 针对 customer 类 做 如 下 修改 : 


。 修改 属性 类 型 ; 
。 移 除 构 造 方 法 中 的 address 参 数 ， 或 者 将 其 变 为 可 空 值 类 型 ， 叉 或 者 
重 载 构造 方法 。 


Address 关 型 本 吴 不 需要 修改 ， 只 需要 修改 使 用 它 的 位 置 。 代 码 清单 15-3 
征 修 改 之 后 的 customer 类 。 我 选择 移 除 构造 器 中 的 address 参 数 。 


代码 清单 15-3 ”将 Address 属 性 变 为 可 衬 类 型 


public class Customer 

















public string Name { get; set; } 


public Address? Address { get; set; } <------ address 现 在 是 可 选 
public Customer(string name) => <------ 从 构造 器 中 移 除 address 参 


Name = name; 


了 


很 好 ， 现 在 代码 意图 很 清晰 了 : Name 属 性 不 能 为 nu11， 而 Address 属 性 可 
能 为 nul1。 如 果 此 时 打印 用 户 address 中 的 country 信 息 ， 编 译 器 会 发 出 不 
同 的 警告 : 


CS8602 Possible dereference of a null reference. 





好 极 了 ! 编译 器 能 够 识别 NullReferenceException 问 题 了 。 现 在 放下 语 
法 层面 的 问题 ， 研 究 可 空 引 用 类 型 的 行为 模式 。 


15.1.4 ”编译 时 和 执行 期 的 可 空 引 用 类 型 


可 空 引 用 类 型 的 一 条 黄金 法 则 是 : 所 有 行为 都 是 显 式 发 生变 化 。 虽 然 代 
码 为 了 表达 非 可 空 类 型 而 发 生 了 变动 ， 但 是 代码 的 行为 没有 改变 。 前 后 
唯一 的 区 别 在 于 编译 时 警告 信息 的 生成 。 没 有 引入 新 类 型 ，CLR 中 也 不 
存在 可 空 引用 类 型 和 非 可 空 引 用 类 型 的 概念 ， 只 需要 attribute 来 填充 可 
空 性 信息 。 这 一 点 与 元 组 元 素 名 称 的 信息 类 似 ， 它 们 都 和 类 型 的 执行 期 
无 天 。 这 一 点 有 以 下 两 个 重要 影响 。 


。 防御 性 编程 依然 属于 最 佳 实践 。 就 目前 的 代码 来 襄 ，Name 属 性 仍 有 
可 能 为 nul11， 因 为 用 户 可 以 忽略 警告 信息 ， 或 者 通过 为 一 个 使 用 C# 
7 的 工程 调用 这 段 代码 ， 所 以 参数 校 验 依然 很 重要 。 
。 为 了 充分 理解 该 特性 ， 需 要 充分 理解 编译 器 发 出 的 警告 信息 。 绝 对 
不 能 忽略 警告 信息 ， 这 些 信息 非常 有 价值 。 
下 面 看 看 前 面 得 到 的 警告 信息 ， 然 后 思考 如 何 规避 筷 : 


Console.writeLine(customer.Address.Country); 


编译 器 是 在 警告 我 们 这 段 代 码 有 风险 ， 因 为 customer.Address 可 能 关 
null。 有 3 种 方式 可 以 把 这 上 段 代 码 安 全 人 化。 首先， 可 以 使 用 空 值 条 件 运 算 
符 和 空 合 并 运算 符 ， 见 代码 清单 15-4。 

代码 清单 15-4 使 用 空 值 条 件 运 算 符 安全 地 解 引 用 


Console.writeLine(customer.Address?.Country ?7? "(Address unknown) 





如 果 customer .Address 为 null， 表达 式 customer .Address?.Country 就 不 


会 计算 country 必 性， 这样 整个 表达 陈 的 最 终结 果 就 是 nul1。 之 后 空 合 

并 运算 符 就 会 提供 一 个 默认 的 值 给 打印 结 末 。 这 样 编译 器 就 会 知道 无 须 

再 为 任何 可 能 为 nul1 的 值 执行 解 引 用 操作 ， 因 此 解除 了 和 警 竺 信息。 

有 些 读者 可 能 不 豆 欢 第 1 种 方式 ， 因 为 大 量 使 用 问号 容易 让 人 军 头 转 

问 。 虽 然 可 以 逐渐 适应 问号 标记 ， 但 这 并 不 是 唯一 可 行 的 方法 。 我 们 可 

以 选择 一 个 思路 简单 ， 但 写 起 来 稍微 烦琐 的 方式 ， 见 代码 清单 15-5。 
代码 清单 15-5 ”使 用 局 部 变量 来 检查 引用 值 


Address? address = customer.Address; <------ 将 address 提 取 到 一 个 新 的 
if (address != null) (本 行 及 以 下 3 行 ) 检查 是 否 为 nul1l1， 如 果 非 hul1l1， 则 为 其 1 














Console.WriteLine(address,Country ) ; 


else 


€ 


Console.WriteLine("(Address unknown)"); 











其 中 有 一 点 需要 注意 : 编译 器 需要 追踪 的 不 仅仅 是 变量 的 类 型 。 如 果 检 
查 规 则 只 是 “ 当 可 空 值 类 型 进行 解 引用 时 发 出 警告 >， 那 么 尽管 这 段 代 码 
是 安全 的 ， 但 编译 器 依然 会 发 出 警告 。 编 译 侨 需要 奶 踪 该 变量 出 现 的 每 
个 位 置 ， 确 定 它 是 不 是 nu11l 值 ， 就 像 编 译 右 追踪 确定 赋值 那样 。 在 代码 
执行 到 if 语 句 时 ， 编 译 器 知道 address 的 值 不 为 nul1l1， 于 是 在 解 引用 时 

将 不 会 生成 警告 信息 。 第 3 种 方式 参见 代码 清单 15-6 ， 它 与 第 2 种 类 似 ， 

但 是 省 略 了 局 部 变量 。 


代码 清单 15-6 ”通过 重复 的 属性 访问 检查 引用 值 


if (customer ,Address != null) 











Console.writeLine(customer.Address.Country); 


else 


€ 


Console.WriteLine("(Address unknown)"); 


即便 理解 了 第 二 个 例子 是 如 何 无 警告 编译 通过 的 ， 看 到 代码 清单 15-6 之 
后 依然 会 感到 惊讶 。 编 译 絮 不 仪 要 退 踊 变量 值 是 谷 为 uv11， 人 还 要 妃 踪 属 
性 值 是 人 否 为 mul11。 它 假定 对 同一 个 属性 的 同一 值 的 两 次 访问 ， 得 到 的 结 








果 应 该 是 相同 的 。 


这 可 能 会 引起 读者 的 担忧 ， 因 为 这 意味 着 新 特性 无 法 保证 nu11 值 不 被 解 
引用 ， 男 一 个 线程 可 能 在 两 次 调用 之 间 修 改 了 Address 属 性 的 值 ， 或 
者 Address 上 自己 有 时 可 能 会 随机 返回 nul1 值 。 此 外 ， 还 有 其 他 方式 可 以 
骗 过 编译 器 ， 让 它 误 以 为 代码 是 安全 的 ， 但 实际 上 并 不 安全 。C# 设 计 团 
队 早 已 经 意识 到 ， 并 且 接 受 了 这 一 事实 ， 因 为 需要 在 安全 性 和 易 用 性 之 
间 寻 找 一 个 平衡 点 。C# 8 之 后 的 代码 要 比 之 前 的 代码 在 nul1 值 上 更 安 
全 ， 但 是 如 果 要 把 代码 变 得 彻底 安全 ， 束 会 涉及 更 大 程度 的 语言 变更 ， 
1 我 们 只 需要 了 解 该 特性 的 局 限 所 在 就 足 
可 以 看 到 ， 编 译 器 在 尽力 理解 哪些 可 能 为 nu11， 哪 些 不 可 能 为 nu11。 如 
果 编 译 器 无 法 获得 足够 的 上 下 文 信息 ， 该 如 何 处 理 呢 ? 

15.1.5 ”damnit 运 算 符 或 者 bang 运 算 符 

至 此 ， 还 有 一 个 新 运算 符 没 有 介绍 : damnit 运 算 符 ， 也 称 damn it 运算 
符 或 者 bang 运 算 符 2。 这 个 运算 符 是 一 个 感叹 号 ， 放 在 表达 式 的 结尾 ， 
用 于 告知 编译 塔 应当 忽略 对 当前 表达 式 的 判断 ， 只 把 它 当 作 非 nul1 值 处 
理 。 


2 微软 应 该 不 会 把 这 个 运算 符 命 名 为 damn it 运算 符 ， 但 是 这 个 名 称 会 在 
社区 中 保留 下 来 ， 束 像 大 家 习惯 把 微软 .NET 编 译 占 平台 称 作 Roslyn。 


该 运算 符 用 于 以 下 两 种 场景 
。 有 时 我 们 比 编译 器 知道 更 多 信息 ， 比 如 知 着 东 个 值 一 定 不 为 nul1， 
即便 编译 器 认为 它 有 可 能 为 nu11; 
。 有 时 我 们 会 故意 传 入 一 个 nul1 值 来 检查 实 参 校 验 的 功能 。 
关于 第 1 种 情况 的 实例 不 太 好 给 出 ， 因 为 通常 要 尽量 避免 这 种 情况 。 在 
很 多 小 例子 中 ， 这 样 几 乎 总 是 可 行 的 ， 但 是 对 于 真实 的 应 用 来 说 就 困难 
了 。 下 面 这 个 方法 会 打印 一 个 字符 串 的 长 度 ， 其 输入 参数 可 以 为 nul1。 
代码 清单 15-7 使 用 bang 运 算 符 为 编译 占 提 供 信息 


static void PrintLength(string? text) <------ 输入 值 是 可 空 的 


























if (!string.IsNullOrEmpty(text)) <------ 如 果 ISNUull10rEmpty 返 回 1 
Console.writeLine($"{text}: {text!.Length}"); <------ 使 用 
else 

Console.writeLine("Empty or null"); 


} 


在 这 个 例子 中 ， 编 译 器 并 不 知道 输入 参数 与 string.IsNullorEmpty 返 回 
值 之 间 的 关系 ， 但 是 我 们 知道 。 如 果 string.IsNullorEmpty 人 返回 false， 
则 输入 值 非 nul1， 因 此 可 以 安全 地 获取 该 字符 串 的 长 度 。 如 果 直 接 调 
用 text .Length， 编 译 器 就 会 发 出 警告 ， 而 使 用 text! .Lenght， 就 是 在 告 
诉 编 译 器 : 我 更 清楚 状况 ， 这 个 值 由 我 负责 判断 。 


如 果 编 译 器 也 能 够 理解 string.IsNullorEmpty 输 入 和 结果 之 则 的 关系 就 
好 了 ，15.1.7 节 会 继续 讨论 这 个 问题 。 


关于 第 2 种 情况 ， 很 容易 找到 实际 的 例子 。 前 面 提 到 校 验 参数 是 否 
为 nul1 的 步 又 不 可 缺少 ， 因 为 参数 值 为 nul1 的 情况 完全 有 可 能 发 生 。 于 
征 需要 为 该 校 验 馆 辑 添加 一 个 单元 测试 ， 但 编译 圳 会 针对 nu11 参 数 发 出 
警告 。 代 码 清单 15-8 给 出 了 这 个 问题 的 解决 方案 。 

代码 清单 15-8 ”在 单元 测试 中 使 用 bang 运 算 符 


public class Customer 


{ 
public string Name { get; } 
public Address? Address { get; } 
public Customer(string name, Address? address) 
Name = name ?7? throw new ArgumentNullException(nameof (nam 
Address = address; 
} 
} 


public class Address 
public string Country { get; } 


public Address(string country) 


Country = country ?2? 
throw new ArgumentNullException(nameof (country)); 


. 


[Test] 
public void Customer_NameValidation() 


Address address = new Address("UK"); 
Assert.Throws<ArgumentNullException>( 
() => new Customer(null!, address)); <------ 为 非 null 形 参 即 


有 


简便 起 见 ， 代 码 清单 15-8 中 把 customer 和 Address 设 置 为 不 可 变 类 型 。 有 
趣 的 是 ， 编 译 堪 不 会 针对 校 验 罗 辑 发 出 任何 警告 。 即 便 它 知道 被 校 验 值 
不 应 当 为 nulL， 但 它 对 于 检查 该 值 的 代码 不 予 警 告 ， 但 是 在 测试 代码 中 
调用 该 方法 时 ， 编 译 吉 会 插手 发 出 警告 : 第 一 个 实 参 非 nul1。 在 先前 的 
C# 版 本 中 ， 测 试 代码 的 lambda 表 达 式 大 致 如 下 : 


() => new Customer(null, address) 














这 行 代码 就 会 产生 一 条 编译 警告。 把 实 参 改 为 nu11! 可 以 满足 编译 占 的 
要 求 ， 而 且 符 合 测 试 的 需求 。 这 样 就 引出 了 为 一 个 问题 ， 在 实际 编码 中 
如 何 使 用 可 空 引 用 类 型 呢 ? 尤其 是 如 何 迁 移 现 有 代码 来 使 用 新 特性 呢 ? 





15.1.6 可 空 引 用 类 型 了 迁移 的 经 验 


检验 新 特性 的 最 佳 方式 就 是 动手 实践 。 我 在 Noda Time 中 使 用 C# 8 预览 
版 构建 来 测试 需要 多 少 新 增 工作 才能 实现 无 和 警告 应 用 新 特性 ， 以 及 是 否 
存在 bug。 下 面谈 谈 我 收获 的 经 验 ， 并 且 给 出 一 些 我 所 遵循 的 原则 。 读 
者 可 能 会 过 到 其 他 一 些 挑战 ， 不 过 应 该 和 我 所 过 到 的 有 很 多 共通 性 。 


1. 在 C# 8 以 前 使 用 attribute 来 表达 可 空 的 意图 
Noda Time 一 直 以 来 都 使 用 attribute (至 少 对 于 所 有 公共 方法 来 说 如 


此 ) 来 表示 某 个 引用 类 型 参数 可 以 为 nu11， 或 者 返回 值 可 能 
为 nulL， 例 如 下 面 的 IDateTimezoneProvider 方 法 签名 : 











[CanBeNu1L1] DateTimeZone GetZzoneoOrNu1L1L([NotNu1L1L] string id); 


它 表示 id 参 数 不 能 为 nu11， 但 方法 可 能 会 返回 一 个 nu11 引 用 。 这 种 
方式 能 够 表达 使 用 空 值 的 意图 ， 但 编译 器 不 能 理解 这 种 方式 。 这 就 
意味 着 ， 第 一 步 需 要 查找 代码 中 原来 允许 nul1 值 的 所 有 地 方 ， 然 后 
把 它们 改 成 使 用 可 空 引 用 类 型 。 


我 刚好 使 用 了 ReSharper 提 供 的 JetBrains 助 记 工 具 ， 这 样 ReSharper 可 
以 进行 和 C# 8 在 语言 中 相同 的 检查 工作 。 这 里 不 会 详细 介绍 助 记 工 
有 具 的 用 法 ， 只 是 提醒 有 这 样 一 个 功能 。 当 然 ， 完 全 可 以 不 采用 这 样 
的 第 三 方 助 记 工 具 ， 我 们 可 以 轻松 创建 并 应 用 自己 的 attribute。 即 
便 没 有 任何 工具 文 持 ， 这 种 方式 也 便于 代码 维护 ， 同 时 为 将 来 迁移 
到 C# 8 使 用 可 空 引 用 类 型 铺 平 了 道路 。 








. 自然 迭代 


第 1 步 完 成 之 后 ， 我 得 到 了 大 约 100 个 警告 ， 于 是 我 把 大 部 分 警告 逐 
个 解决 了 并 重新 构建 项 目 。 第 2 步 完 成 之 后 ， 我 得 到 了 110 个 警告 
比 之 前 更 多 了 ! 于 是 我 又 把 大 部 分 警告 逐个 解决 了 ， 然 后 重新 
构建 。 在 第 3 步 完成 之 后 ， 我 得 到 了 大 约 100 个 警告 ， 于 是 我 又 逐个 
解决 然后 重新 构建 。 


我 已 经 不 记得 这 样 的 工作 重复 了 多 少 次 ， 但 它 并 不 是 什么 坏 信 号 。 
把 代码 库 改 造成 文 持 可 空 引 用 类 型 的 过 程 就 像 打 地 鼠 : 修改 了 一 处 
可 空 性 之 后 ， 使 用 该 变量 的 所 有 地 方 就 都 出 现 和 警告 信息 了 ， 于 是 再 
修改 这 些 地 方 ， 问 题 义 会 转移 到 其 他 地 方 。 关 于 是 否 要 为 代码 库 改 
造 可 空 性 ， 值 得 认真 思考 。 这 一 过 程 中 所 付出 的 蔷 兰 也 在 意料 和 情 
理 之 中 。 

如 果 一 部 分 代码 需要 某 个 值 是 可 空 的 ， 而 男 一 处 义 需 要 它 古 非 可 空 
的 ， 就 比较 麻烦 了 。 这 并 不 是 C# 8 引入 的 问题 ， 而 是 该 特性 暴露 出 
来 的 问题 。 至 于 如 何 处 理 这 种 问题 ， 需 要 具体 问题 具体 分 析 。 























. bang 运 算 符 使 用 的 最 佳 实践 


如 果 产 品 代码 中 需要 使 用 bang 运 算 符 ， 最 好 添加 一 条 注释 解释 理 
由 。 如 果 注 释 遵循 比较 好 的 搜索 格式 (例如 在 注释 中 使 
用 NULLABLEREF) ， 会 方便 之 后 查找 。 随 着 工具 的 不 断 改进 ， 将 来 





也 许可 以 移 除 这 些 运 算 符 。 不 是 说 不 应 该 用 bang 运 算 符 ， 而 是 说 使 
用 该 运算 符 的 前 提 古 我 们 比 编译 占 知 道 更 多 信息 ， 但 切 勿 “盲目 目 


信 ” 
百 o 


我 更 多 把 bang 运 算 符 用 于 测试 代码 中 ， 而 且 大 部 分 是 校 验 代 码 的 测 
试 ， 就 像 前 面 那个 例子 一 样 。 除 此 之 外 ， 如 采 我 认为 某 个 值 应 当 是 
非 空 的 ， 我 会 欣然 强制 编译 絮 也 接受 这 一 设 定 ， 尤 其 当 我 知道 将 来 
调用 它 的 代码 还 会 校 验 该 值 时 。 如 果 我 错 了 ， 那 么 测试 的 结果 应 该 
是 ArgumentNullException 或 者 NullReferenceException,， 这 样 可 以 
接受 ， 因 为 这 只 是 证 明了 我 的 假设 不 合理 。 通 第 说 来 ， 测 试 代码 不 
应 像 产 品 代 码 那么 防御 性 强 。 让 测试 代码 直接 失败 ， 好 于 优雅 地 处 
理 异常 。 


. 泛 型 空 值 处 理 的 不 一 致 性 


在 Noda Time 中 为 引用 类 型 实现 IEqualitycomparer<T> 接 口 很 奇怪 ， 
因为 该 接口 在 可 空 引 用 类 型 出 现 之 前 束 已 存在 。Equals 和 
GetHashcode 都 是 按照 形 参 类 型 T 定 义 的 ， 但 二 者 处 理 nul1 的 行为 并 
不 一 致 。Equals 天 然 能 够 处 理 nul11 值 ， 而 GetHashcode 在 遇 到 nul1 值 


时 会 抛 出 ArgumentNu1LLException。 


在 这 种 情况 下 ， 如 何 应 用 可 空 引 用 类 型 ， 目 前 尚 不 明确 。 假 设 我 们 
为 Period 类 型 定义 了 等 价 比 较 器 ， 那 么 应 该 实现 
IEdqualityCcomparer<Period?> 来 允许 nul1 实 参 昵 ? 还 是 实现 
IEqualityCcomparer<Period> 来 禁 上 Fnu11 实 参 呢 ? 不 管 采用 哪 种 方 
式 ， 调 用 方 都 会 在 编译 时 或 者 执行 期 遇 到 问题 。 


抛 开 实现 层面 不 谈 ， 即 便 对 于 接口 本 身 ， 如 何 清晰 地 表达 可 空 性 也 
古 一 道 难题 。 关 于 如 何 处 理 泛 型 类 型 实 参 ,或许 需要 更 多 语言 设计 
工作 。 如 果 只 是 在 接口 中 使 用 T?， 似 乎 也 不 太 合适 。 这 是 因为 如 果 
T 古 值 类 型 ， 是 不 应 该 接收 Nullable<T> 参 数 的 。 


虽然 我 恰好 在 IEqualitycomparer<T> 中 过 到 这 个 问题 ， 但 在 其 他 接 
口 甚 至 泛 型 类 中 也 会 有 同样 的 问题 。 这 里 提 到 它 ， 旨 在 提醒 读者 遇 
到 同样 问题 的 时 候 ， 不 要 以 为 自己 出 错 了 。 

















最 终结 果 


Noda Time 的 代码 库 并 不 庞大 ， 但 也 不 算 小 。 束 个 过 程 我 花费 了 大 
概 5 个 小 时 ， 其 中 还 包含 诊断 Roslyn 预 览 版 的 pug。 最 终 我 在 Noda 
Time 中 发 现 了 一 个 未 修复 的 bug: TimezoneInfo.Local 在 Mono 的 某 
些 环境 中 返回 nul1 值 导致 的 不 一 致 性 。 我 还 发 现 遗 漏 了 一 些 助 记 
人 符 ， 并 且 针 对 茶 些 内 部 成 员 重 新 表达 了 代码 意图 。 


我 对 这 一 结果 十 分 满意 。 编 译 器 可 以 检查 代码 一 致 性 这 件 事 让 我 信 
心 大 增 。 此 外 ， 我 发 布 了 基于 C# 8 构建 的 Noda Time 版 本 ， 使 用 C# 
8 的 人 会 因此 获 益 。 这 样 一 来 ， 很 多 执行 期 错误 在 就 能 提前 到 编译 
时 被 发 现 了 ， 用 户 在 使 用 Noda Time 时 也 会 更 加 放心 ， 可 谓 双 赢 。 


这 些 经 验 部 是 基于 2018 年 上 半年 的 C# 8 预览 版 本 的 ， 该 版 本 肯定 不 
是 语言 设计 和 实现 的 最 终 版 本 。 接 下 来 展望 一 下 未 来 。 


15.1.7 未 来 的 改进 


在 2018 年 6 月 ， 我 和 C# 语 言 设计 团队 的 主管 Mads Torgersen 一 起 参 会 和 参 
加 用 户 组 讨论 。 我 根据 自己 编写 Noda Time 的 经 验 罗 列 了 关于 特性 需求 
和 问题 的 清单 ， 他 的 答复 肯定 了 我 对 语言 特性 的 预期 。 


C# 设 计 团 队 意识 到 当前 的 预 虎 版 本 还 不 足以 成 为 主流 版 本 ， 有 一 人 
还 需要 继续 打磨 ， i ee 
面 列 出 的 这 些 并 不 能 宫 括 所 有 特性 ， 但 我 个 人 比较 感 兴 


1. 为 编译 右 提 供 语义 性 更 强 的 信息 


15.1.5 节 介绍 bang 运 算 符 时 ， 说 过 编译 器 并 不 理解 

string， 人 (编译 峰 不 会 推 新 : 如 果 访 方法 返 
回 false， 输 入 值 就 不 可 能 为 null。) 这 只 是 输入 和 输出 之 间 关 系 
能 够 帮助 编译 器 做 推断 的 一 种 情况 。 下 面 3 个 例子 都 是 编译 器 本 可 
以 不 发 出 警告 的 情况 (也 包含 string.IsNullorEmpty) 。 


string? a = 
if 区 oe 




















Console.writeLine(a.Length); 


object b= ...; 
if (!ReferenceEquals(b, null)) 


Console.writeLine(b.GetHashCode( )); 


XElement c = .. 
string d = rd Cc; 


这 3 种 情况 的 代码 语义 都 很 重要 。 编 译 器 应 当知 道 以 下 信息 。 


o 如 果 string.IsNullorEempty 返 回 false， 输 入 束 不 为 null。 

o 如 果 ReferenceEquals 返 回 false， 其 中 一 个 输入 为 nul1， 那 么 
另 一 个 输入 不 可 能 为 nul1。 

o 如 果 xElement 到 string 的 转换 是 非 nul1 的 ， 那 么 其 结果 也 应 议 
是 非 nul1 值 。 


这 些 都 是 关于 输入 和 输出 的 示例 ， 目 前 还 无 法 表达 这 些 关 系 。 
为 如 果 编 译 器 能 够 识别 这 些 关 系 ， 大 部 分 bang 运 算 付 砚 不 再 需 
了 。 那么 编译 器 如 何 才能 获取 这 些 附 加 信 ， 昌 呢 ? 


以 上 特定 的 例子 而 言 ， 一 种 方法 是 通过 便 编 码 将 信息 告知 编译 

。 这 么 做 对 于 C# 设 计 团 队 来 说 最 容易 实现 ， 但 是 不 太 令 人 满意 。 
ee 
Noda Time 中 能 够 表达 这 种 关系 。 


很 有 可 能 C# 设 计 团 队 会 设计 一 门 新 的 小 型 语言 。 在 这 门 语言 中 ， 可 
以 使 用 attribute 来 回 编译 器 提供 这 种 附加 的 语义 信息 。 有 了 这 些 信 
恩 ， 编 译 器 就 可 以 更 智能 地 判断 东 个 值 是 否 训 该 “ 绝 不 为 空 ”。 不 过 
这 种 方式 所 需要 的 设计 和 实现 工作 会 大 增 ， 但 解决 方案 将 更 完整 。 











2 关于 之 型 疝 这 大 电 考 

泛 型 为 可 空 性 的 设计 带 来 了 有 意思 的 挑战 。 前 面 讲 
IEqualitycomparer<T> 的 时 候 提 到 了 一 个 例子 ， 但 实际 问题 远 不 止 
于 此 ， 考 虑 下 面 这 段 在 C# 7 中 合法 的 代码 : 


public class Wrapper<T> 








public T Value { get; set; } 


如 果 这 段 代 码 是 合法 的 ， 那 么 它 的 含义 是 什么 ? 特别 是 构建 一 个 该 
类 型 的 实例 ， 但 不 设置 value 属 性 ， 其 结果 是 什么 ? 


对 于 wrapper<int> 来 说 ，value 的 默认 值 是 0。 

对 于 wrapper<int?> 来 说 ，value 的 值 是 int? 的 nul1 值 。 

对 于 wrapper<string> 来 说 ，value 的 值 是 nu11 引 用 ， 但 这 

与 value 是 非 nu11 引 用 相 冲 突 。 

对 于 wrapper<string?> 来 说 ， value 的 值 是 nu11 引 用 。 这 样 没有 
问题 ， 因 为 value 的 类 型 是 可 空 的 string 类 型 。 


如 果 考 虑 执行 期 的 值 ， 就 更 复杂 了 ，wrapper<int> 和 wrapper<int?> 
是 不 同 的 CLR 类 型 ，wrapper<string> 和 wrapper<string?> 则 是 相同 
的 CLR 类 型 。 


虽然 不 清楚 C# 8 会 如 何 解 决 这 一 问题 ， 但 是 起 码 C# 设 计 团队 已 经 意 
识 到 了 它 的 存在 。 幸 好 不 需要 我 来 解决 这 个 问题 ， 光 是 想 想 这 个 问 
题 就 让 人 头疼 。 


这 个 例子 还 只 是 C# 7 版 本 ， 并 没有 显 式 地 使 用 可 空 类 型 ， 如 果 在 泛 
型 类 型 或 方法 中 使 用 T? 叉 会 怎么 样 呢 ? 


在 C# 7 中 ， 如 果 有 类 型 形 参 T， 那 么 只 有 当 T 的 类 型 约束 是 非 可 空 值 
类 型 时 ， 才 能 使 用 T? 类 型 ， 它 的 含义 是 Nullable<T>。 这 样 很 简 
单 ， 但 是 可 空 引 用 类 型 怎么 办 呢 ? 看 起 来 还 需要 新 的 关于 非 可 空 引 
用 类 型 的 类 型 约束 : 知 限 制 T 为 非 可 空 z 值 类 型 或 非 可 空 x 引 用 类 型 ， 
则 可 以 使 用 T?。 我 认为 不 会 有 类 似 于 “ 某 种 非 可 空 类 型 > 的 类 型 约 
束 ， 因 为 对 于 值 类 型 和 引用 类 型 ， 可 空 类 型 的 含义 有 很 大 差异 。 


oO 


0 


oO 


O 〇 











. 执行 参数 校 验 

到 目前 为 止 ， 代 码 变更 都 发 生 在 编译 时 。 由 编 诺 喜 生成 的 开 代 码 并 
没有 变化 ， 因 此 仍 需 要 执行 参数 校 验 ， 以 防止 那些 忽略 编译 融 警 告 
的 代码 使 用 bang 运 算 符 ， 或 者 由 早期 C# 版 本 编译 的 代码 。 


昌 然 这 么 做 没有 问题 ， 但 校 验 部 分 的 代码 仍 是 样板 代码 。 空 合并 运 


算 符 、nameof 运 算 符 以 及 throw 表 达 式 这 些 特性 都 能 用 于 在 某 些 情 
况 下 改进 校 验 代 码 ， 但 参数 校 验 依 旧 烦 琐 且 容易 被 遗 瑟 。 

目前 正在 论证 的 一 个 特性 是 : 在 参数 名 后 面 添加 一 个 感叹 吕 ， 编 译 
人 
0 下 代码 : 


static void PrintLength(string text) 





string validated = 
text ?3? throw new ArgumentNullException(nameof (text)) 
Console.writeLine(validated.Length); 


可 以 改写 成 : 


static void PrintLength(string text!) <------ 自动 做 空 值 检 查 





Console .writeLine(text.Length); 





属性 也 可 以 以 相同 的 方式 实现 目 动 校 验 。 


. 激活 可 空 性 检查 


在 我 用 过 的 预览 版 本 中 ， 可 空 性 检查 古 默 认 激 活 的。 虽然 可 以 按照 
一 般 的 方式 来 茶 止 警告 ， 但 很 有 可 能 C# 8 在 发 布 之 前 还 有 很 多 更 细 
微 的 设置 。 这 里 需要 考虑 很 多 情况 。 


当 开 发 人 员 将 编译 器 版 本 升级 到 C# 8 后 ， 应 该 不 太 愿 意 看 到 出 现 新 
的 警告 信息 。 如 果 项 目的 设置 是 把 警告 当 作 错 误 来 处 理 ， 这 一 扣 束 
显得 尤为 重要 了 。 我 认为 默认 状态 下 应 当 关 闭 可 空 性 检查 ， 全 少 对 
于 现 有 项 目 来 说 应 如 此 。 


并 不 是 所 有 类 库 都 会 同时 采纳 C# 8。 对 于 那些 已 经 开启 了 C# 8 可 空 
性 检查 的 类 库 来 说 ， 应 当 兼 容 尚 未 迁移 到 C# 8 的 库 。 可 能 需要 报告 
尽 可 能 少 的 错误 ， 例 如 编译 器 可 以 将 传 给 类 库 的 所 有 输入 视 作 可 衬 
值 ， 而 把 本 库 的 所 有 输出 值 都 视 作 非 可 空 值 。 对 于 已 经 完成 迁移 的 
库 ， 最 好 有 某 种 方法 对 外 给 出 提示 。 






































在 决定 迁移 茶 个 项 目 以 使 用 可 空 引用 类 型 时 ， 开 发 人 员 可 能 希望 通 
过 厦 干 改动 来 完成 迁移 。 也 有 可 能 项 目 中 的 茶 些 代码 是 目 动 生成 
的 ， 这 部 分 代码 不 易 表 达 可 空 性 。 那 么 最 好 每 个 类 型 都 可 以 对 外 表 
示 目 己 “ 能 够 表达 可 空 性 ”。 


这 些 考量 对 于 C# 来 说 是 全 新 的 。 我 还 从 未 过 到 过 哪个 语言 特性 在 羔 
容 性 上 影响 如 此 广泛 。 硕 望 C# 设 计 团 队 在 最 终 发 布 C# 8 之 前 通过 行 
干 次 碗 代 来 逐步 完成 。 


可 空 引 用 类 型 很 有 可 能 是 C# 8 最 大 的 新 特性 ， 而 目前 预览 版 中 还 有 
其 他 一 些 特性 ， 其 中 我 最 喜欢 switch 表 达 式 。 


15.2 switch 表达 式 


自 C# 面 世 便 存在 switch 语 句 。 迄 今 为 上 上， 关于 switch 语 名 的 唯一 变更 是 
C# 7 关于 switch 语 句 和 模式 匹配 的 搭配 使 用 。switch 语 句 如 今 依然 是 很 
重要 的 控制 结构 : 如 果 此 case 匹 配 ， 就 如 此 执行 ， 如 果 彼 case 匹 配 ， 就 
如 彼 执行 。 很 多 switch 语 句 的 用 法 是 函数 式 的 ， 每 个 case 都 会 计算 出 一 
个 结果 : 如 果 此 case 匹 配 ， 则 结果 是 X， 如 果 彼 case 匹 配 ， 则 结果 为 
Y。 这 在 函数 式 编程 语言 中 是 常见 的 结构 。 函 数 式 编程 语言 的 很 多 功能 
是 纯粹 用 模式 匹配 来 进行 表达 的 。 


而 表达 式 主体 成 员 的 出 现 ， 让 switch 语 句 如 芒 在 背 。 很 多 方法 可 以 仅 用 
个 表达 式 来 实现 ， 但 switch/case 依 然 只 能 使 用 代码 块 主体 ， 而 不 能 使 
用 表达 式 主体 。 


C# 8 引入 了 switch 表 达 式 作为 switch 语 句 的 一 个 可 选项 。switch 表 达 式 
使 用 一 种 与 switch 语 句 不 同 的 语法 ， 下 面 比 较 二 者 。 第 12 章 介绍 模式 匹 
配 时 ， 曾 举 过 一 个 使 用 switch 语 句 来 计算 不 同形 状 周 长 的 例子 ， 代 码 如 
1 

















static double Perimeter(Shape shape) 
switch (shape) 


case null: 

throw new ArgumentNullException(nameof (shape)); 
case Rectangle rect: 

return 2 * (rect.Height + rect.width); 


case Circle circle: 
return 2 * PI * circle.Radius; 
case Triangle triangle: 
return triangle.SideA + triangle.SideB + triangle,Sid 
default: 
throw new ArgumentException( 
$"Shape type {shape.GetType()} perimeter unknown" 
nameof (shape) ); 


} 


rn 6 
方法。 


代码 清单 15-9” ”switch 语句 改写 成 switch 表 达 式 


static double Perimeter(Shape shape) 


t 





return shape switch 


{ 


null => throw new ArgumentNullException(nameof(shape)), 
Rectangle rect => 2 * (rect.Height + rect.Wwidth), 
Circle circle => 2 * PI * circle.Radius, 
Triangle triangle => 
triangle.SideA + triangle.SideB + triangle.Ssidec, 
_ => throw new ArgumentException( 
$"Shape type {shape.GetType()} perimeter unknown", 
nameof (shape)) 


}; 
} 


其 中 很 多 内 容 需 要 说 明 ， 无 法 将 它们 一 一 标记 。switch 语 句 和 和 switch 表 
达 式 的 区 别 如 下 。 


原先 是 switch(value)， 现 在 是 value switch。 

。 如 果 模 式 匹 配 成 功 ， 宽 箭头 => 放 置 于 模式 和 返回 值 之 间 (switch 语 
句 使 用 冒号 ) 。 

。 switch 表 达 式 中 取消 了 case 关 键 字 。 宽 箭头 => 左 侧 是 模式 ， 该 模式 
可 以 有 由 when 关 键 字 引 导 的 哨兵 语句 。 

。 宽 箭 头 => 右 侧 是 表达 式 。 省 略 了 return 关 键 字 ， 因 为 每 个 模式 的 结 
果 都 是 一 个 值 或 者 throw 语 句 。 类 似 地 ，switch 表 达 式 也 没有 break 
语句 。 

。 每 个 模式 都 用 逗号 分 隔 。 如 果 要 把 switch 语 句 改写 成 switch 表 达 








式 ， 那 么 通常 需要 把 分 号 改 成 逗号 。 
i 
多 结果 。 


我 通常 把 switch 表 达 式 直接 用 于 方法 的 返回 ， 读 者 也 可 以 把 它 用 于 任何 
可 以 使 用 表达 式 的 地 方 ， 例 如 : 


double circumference = shape switch 


oe 和 以 前 一 样 的 switch 体 代码 





}; 


这 么 写 没 有 问题 ， 不 过 前 面 提 到 过 ，switch 表 达 式 最 棒 的 一 点 在 于 它 可 
代码 清单 15-10 使 用 表达 式 主 体 方法 改进 了 代 
马 清 单 15-9。 


代码 清单 15-10 使 用 switch 表 达 式 实现 表达 式 主体 方法 


static double Perimeter(Shape shape) => 
shape switch 


null => throw new ArgumentNullException(nameof (shape)), 
Rectangle rect => 2 * (rect.Height + rect.Wwidth), 
Circle circle => 2 * PI * circle.Radius, 
Triangle triangle => 
triangle.SideA + triangle.SideB + triangle.Ssidec, 
_ => throw new ArgumentException( 
$"Shape type {shape.GetType()} perimeter unknown", 
nameof (shape)) 


}; 


读者 可 以 根据 自己 的 喜好 来 排 布 代码 ， 比 如 把 shape switch 也 放 到 第 一 
行 ， 或 者 把 大 括号 缩 进 到 与 方法 声明 垂直 对 齐 ， 


switch 语 句 和 switch 表 达 式 之 间 的 一 个 重要 区 别 是 ，switch 表 达 式 必须 
返回 一 个 结果 (或 异常 )。switch 表 达 式 不 允许 什么 都 不 做 ， 什 么 值 都 
不 产生 。 可 以 使 用 抛弃 符 .,， 也 可 以 编写 不 完全 罗 配 的 switch 表 达 式 。 
就 我 目前 使 用 的 预 史 版 本 而 言 ， 这 样 做 会 引 及 编译 占 和 警告 ， 但 接 下 来 编 
译 堪 还 是 会 生成 合法 的 开 代 码 。 这 个 问题 其 实 应 当 引 发 一 个 编译 错误 ， 
或 者 编译 器 可 以 插入 一 些 抛 出 异常 的 代码 (可 以 

是 InvalidoperationException ) 来 表示 代码 进入 了 错误 的 状态 。 











目前 我 遇 到 的 switch 表 达 式 的 一 个 问题 是 : 无 法 表达 多 个 模式 指向 同一 
个 结果 。 在 switch 语 句 中 可 以 将 多 个 case 标 签 指向 同一 个 代码 块 ， 但 
在 switch 表 达 式 中 没有 这 种 机 制 。 不 过 C# 设 计 团 队 已 经 了 解 了 这 一 需 
求 。 和 希望 在 C# 8 正式 发 布 之 前 可 以 完善 这 部 分 功能 。 


C# 8 的 模式 匹配 不 仅仅 伴随 着 switch 表 达 式 得 到 了 改进 ， 模 式 匹 配 本 身 
也 在 成 长 。 


15.3 ” 般 套 模式 匹配 
前 情 提要 ，C# 7 中 的 模式 匹配 共 包括 ; 





。 类 型 模式 (expression is Type t) ; 
。 常量 模式 (expression is 10、expression is nul1 等 ) ; 
e var 模 式 (expression is var v) 。 


C# 8 计划 推出 怠 套 模式 《模式 内 部 可 以 峙 套 子 模式 ) ， 与 分 解 模式 类 
似 。 下 面 先 通过 实践 解释 裔 套 模 式 ， 然 后 讨论 分 解 模 式 。 


15.3.1 使 用 模式 来 匹配 属性 


要 在 主 模式 内 添加 额外 的 模式 来 下 配属 性 ， 可 以 使 用 大 括号 。 大 括 写 内 
部 是 针对 属性 的 不 同 模 式 ， 模 式 间 使 用 逗号 分 阳 。 内 部 的 模式 在 罗 配 属 
性 时 ， 可 以 使 用 所 有 常规 匹配 模式 。 沿 用 代码 清单 15-10 中 计算 四 边 
形 、 圆 和 三 角形 周 长 的 例子 : 

Rectangle rect => 2 * (rect.Height + rect.width), 


Circle circle => 2 * PI * circle.Radius, 
Triangle triangle => triangle.SideA + triangle.SideB + triangle.s 


在 每 个 case 中 ， 其 实 不 需要 shape 本 里， 而 需要 shape 的 属性 。 使 用 构 套 
的 var 模 式 来 根据 不 同 的 值 匹 配 这 些 属 性 ， 然 后 使 用 模式 变量 获取 所 需 
要 的 属性 值 。 代 码 清单 15-11 是 使 用 了 髓 套 模式 的 完整 方法 。 

代码 清单 15-11 匹配 拱 套 模式 


static double Perimeter(Shape shape) => Shape Switch 




















null => throw new ArgumentNullException(nameof(shape)), 


Rectangle { Height: var h，Width: var w } => 2* (h + w), 
Circle { Radius: var r } -> 2 PI 
Triangle { SideA: var a, SideB: var b, SideC: var c } => at+t 
=> throw new ArgumentException( 

$"Shape type {shape.GetType()} perimeter unknown", nameof 


}; 


这 种 写法 比 之 前 的 更 简洁 吗 ? 并 不 确定 。 我 可 能 还 是 会 选择 代码 清单 
15-10 的 写法 。 稍 后 有 一 个 更 复杂 的 例子 ， 在 那个 例子 中 该 特性 的 应 用 
会 更 有 说 服 力 ， 不 过 也 更 难 理解 。 


请 注意 ， 本 例 中 不 再 通过 模式 变量 获取 Rectangle、circle 或 

者 Triangle Crect、 es 本 身 了 ， 因为 没有 必要 获取 ， 
并 不 是 因为 不 能 获取 。 例 如 可 以 通过 以 下 模式 来 描述 一 个 高 度 为 0 的 平 
面 形状 : 


Rectangle { Height: 0 } rect => $"Flat rectangle of width {rect.w 


Sl 但 只 需要 检查 其 中 几 个 时 ， 这 种 方式 会 很 有 用 。 接 
下 来 介绍 分 解 模式 。 











15.3.2 分解 模式 





12.1 节 介绍 过 元 组 的 分 解 ，12.2 节 讨论 了 通过 Deconstruct 方 法 实现 自 定 
义 分 解 。 C# 8 增加 了 分 解 特性 对 模式 的 文 持 。 对 于 下 面 这 个 例子 ， 我 们 
会 很 自然 地 想到 把 Triangle 分 解 成 3 条 边 的 操作 : 


public void Deconstruct 
(out double sideA, out double sideB, out double sideC) => 
(sideA, sideB, sideC) = (SideA, SideB, SidecCc); 


然后 可 以 简化 上 面 计算 周 长 的 代码 ， 省 略 每 个 属性 的 名 称 。 此 前 的 代码 
是 ; 


Triangle { SideA: var a, SideB: var b, SideC: var C } => ar+ b+ 


可 以 简化 为 : 


Triangle (var a, var b, var c) => &a + b + C 


还 是 同样 的 问题 ， 新 写法 比 匹配 类 型 的 写法 更 易 读 吗 ? 或 许 吧 。 随 着 时 





间 的 推移 ， 每 个 开 用 人 员 都 会 束 模 式 匹配 建立 上 自己 的 编码 习惯 ， 并 了 最 终 
在 代码 库 中 形成 茶 种 编码 规范 。 


15.3.3 ”忽略 模式 中 的 类 型 
这 种 可 以 检测 对 象 内 部 的 模式 匹配 的 用 途 十 分 广泛 。 如 果 给 每 个 模式 都 


指定 类 型 ， 会 显得 有 些 多 此 一 举 。 回 到 之 前 customer 和 address 关 于 可 空 
引用 类 型 的 例子 ， 这 次 使 用 最 初 的 数据 模型 . 全 部 可 变 ， 全 部 可 空 : 


public class Customer 








public string Name { get; set; } 
public Address Address { get,; set; } 
} 


public class Address 


public string Country { get; set; } 


假设 需要 根据 客户 地 址 中 的 国家 信息 创建 不 同 的 问候 方式 。 输 入 值 的 类 
型 是 customer， 但 在 模式 匹配 时 我 们 不 希望 重复 出 现 类 型 信息 。 而 在 匹 
配 Address 属 性 时 ， 因 为 Address 的 类 型 不 会 改变 ， 所 以 我 们 也 不 希 

望 Address 的 类 型 信息 重复 出 现 。 


代码 清单 15-12 使 用 多 个 模式 匹配 不 同类 型 的 客户 ， 还 使 用 了 人 Q 模 
式 。 如 模式 是 属性 模式 的 一 种 特殊 情况 ， 它 不 要 求 匹 配 任何 属性 。 该 模 
式 可 以 匹配 任何 非 nul1 值 。 

代码 清单 15-12 ”使 用 不 同 的 模式 来 精准 匹配 客户 


static void Greet(Customer customer ) 


{ 
string greeting = customer switch 
{ Address: { Country: "UK" } } => <------ 匹配 的 country 为 UI 
"Welcome, customer from the United Kingdom!", 
{ Address: { Country: "USA" } } => <------ 匹配 的 country 为 \ 
"Welcome, customer from the USA!", 
{ Address: { Country: string country } } => <------ 匹配 任 














$"Welcome, customer from {country}!", 
{ Address: { } } => <------ 匹配 任意 address 














"Welcome, customer whose address has no country!", 

{ } => <------ 匹配 任意 customer， 无 论 address 是 否 为 nu11 
"Welcome, customer of an unknown address!", 

二 > 
"Welcome, nullness my old friend!" <------ 匹配 所 有 ， 无 

















/ 
Console.writeLine(greeting); 





其 中 模式 的 顺序 很 重要 。 例 如 一 位 来 自 USA 的 客户 可 以 匹配 除 第 一 个 外 
的 所 有 模式 。 也 可 以 通过 让 模式 变 得 更 具 针 对 性 (使 用 常量 null 模 式 来 
匹配 那些 Address 为 nul1 的 值 ) 实现 排他 ， 不 过 通过 顺序 实现 会 更 简单 


二 

















C# 8 对 模式 匹配 的 增强 ， 使 得 现在 很 多 需要 if 语句 来 完成 的 功能 ， 将 来 
使 用 模式 匹配 就 能 实现 。switch 表 达 式 对 此 贡献 凯 多 。 我 认为 以 后 会 有 
越 来 越 多 的 代码 使 用 模式 匹配 。 不 过 需要 牢记 ， 凡 事 过 狂 不 及 。 不 是 所 
有 使 用 模式 匹配 的 代码 都 会 比 过 去 的 控制 结构 更 简单 ， 不 过 C# 的 这 项 改 
~ 巨大 。 下 面 要 介绍 的 一 对 特性 是 由 两 个 新 的 framework 类 型 带 来 
科 。 











15.4 index 和 range 


和 可 空 引用 类 型 以 及 模式 处 理 相 比 ，index 和 range 特 性 是 很 小 的 特性 ， 
并 且 二 者 是 组 合 使 用 的 。 不 过 我 认为 随 看 时 间 的 推移 ， 大 家 束 会 感叹 它 
们 为 何 姗 姗 来 迟 。 在 讲解 细节 前 ， 移 看 一 个 小 例子 。 

代码 清单 15-13 ”通过 range 移 除 一 个 字符 串 中 的 首尾 字符 


string quotedText = "'This text was in quotes'"，; 
Console.writeLine(quotedText ) ; 
Console.writeLine(quotedText.Substring(1..^1)); <------ 使 用 ranges 


代码 执行 结果 如 下 : 


'This text was in quotes' 
This text was in quotes 


需要 重点 关注 代码 中 加 粗 的 1..^1 表 达 式 。 为 了 理解 该 表达 式 ， 需 要 介 
绍 两 个 新 类 型 。 





15.4.1 index 与 range 类 型 和 字面 量 


该 特性 的 基本 思想 很 简单 。 有 Index 和 Range 两 个 结构 体 〈 将 来 由 
framework 来 提供 ) ， 目 前 需要 在 代码 中 上 自行 定义 。 


。 Index 表 示 一 个 整 型 数 ， 它 表示 某 个 可 索引 值 的 起 始 或 结尾 。index 
不 能 为 负 值 。 

。 Range 是 一 对 index 的 组 合 ， 两 个 index 分 别 表 示 range 的 起 始 值 和 终止 
值 。 





由 此 引出 了 3 点 重要 语法 。 


从 int 创 建 一 个 起 始 位 置 的 Index 的 普通 隐 式 转换 。 

一 个 新 的 一 元 运算 符 ^， 该 运算 符 和 一 个 int 值 连用 ， 用 于 创建 一 个 
这 里 的 0 值 表示 刚刚 跨 过 末尾 元 素 ，1 表 示 最 后 
I 

一 个 新 的 二 元 运算 符 ..， 其 操作 数 〈 可 选 ) 用 于 创建 Range 的 起 始 
值 和 终止 值 。 


3 在 索引 器 中 使 用 Index 感 觉 有 些 奇怪 ， 但 当 和 range 连 用 时 ， 束 合理 多 
了 ， 因 为 range 所 指定 的 上 界 值 不 包括 在 内 。 值 为 ^6 的 range 上 自然 就 成 
了 “序列 的 末尾 位 置 ”。 

. .运算 符 是 准 二 元 运算 符 ， 因 为 它 的 操作 数 个 数 可 以 是 0、1 或 者 2。 代 
码 清单 15-14 展 示 了 上 所 有 情况 ， 其 中 并 没有 应 用 index 或 range， 只 是 单纯 
地 创建 了 一 些 值 。 


代码 清单 15-14 index 与 range 字 面 量 





Index Start = 2; 
Index end = 人 ^2; 


Range all = ..; 
Range Startonly = start..; 
Range endonly = . .end; 


Range StartAndEnd = start..end; 
Range implicitIndexes = 1..5; 


有 一 点 需要 注意 : range 的 起 始 值 和 终止 值 可 以 是 任意 索引 值 。 例 如 可 
以 创建 一 个 ^5. .16 来 表示 从 倒数 第 5 个 元 素 到 正 数 第 10 个 元 素 之 间 的 范 








围 。 虽 然 这 种 写法 极其 罕见 ， 但 是 合法 。 


以 上 就 是 关于 该 特性 语言 直接 支持 的 部 分 。 当 该 特性 获得 framework 支 
持 之 后 ， 才 能 真正 得 到 应 用 。 


15.4.2 ”应 用 index 和 range 


本 市 的 所 有 例子 都 需 要 C# 8 预览 版 构建 所 提供 的 扩展 方法 和 扩展 运算 
符 。 有 具体 的 API 将 来 可 能 会 变化 ， 而 且 预 览 版 中 提供 的 这 些 扩展 只 能 用 
于 有 限 的 几 个 类 型 中 ， 不 过 足以 展示 该 特性 的 优势 了 。 代 码 清单 15-13 
展示 了 Substring 方 法 如 何 使 用 Range。index 和 range 都 可 以 应 用 于 可 以 表 
示 序 列 的 类 型 ， 例 如 : 


® 数组 ; 
e span; 


。 字符 串 《〈 作 为 UTF-16 编 码 单元 的 序列 ) 。 
它们 都 文 持 两 种 操作 : 


。 提取 茶 个 元 素 ; 
。 创建 原 序 列 的 子 序列 。 


从 序列 中 提取 单个 元 素 ， 以 往 通 过 一 个 int 参 数 的 索引 值 就 能 做 到 ; 但 
是 对 于 获取 最 后 一 个 元 素 这 样 的 操作 ， 并 没有 统一 的 方式 。Index 类 型 
通过 正 数 和 倒数 的 方式 解决 了 这 一 问题 。 对 于 创建 子 序列 的 操作 ， 以 往 
不 同 的 类 型 需要 采取 不 同 的 形式 ， 例 如 span<T> 会 提供 slice 方 法 ， 

而 string 会 提供 substring 方 法 。 


在 添加 了 有 索引 器 对 Index 和 Range 的 重 载 方法 之 后 ， 就 可 以 对 所 有 相关 类 
型 执行 一 致 且 便捷 的 操作 了 。 代 码 清单 15-15 展 示 了 对 字符 串 和 
span<int> 的 两 种 相似 的 方法 调用 。 


代码 清单 15-15 ”通过 使 用 index 和 range 的 索引 右 重 载 方法 操作 字符 
串 和 span 


string text = "hello world"; 
Console.writeLine(text[2]); <------ 使 用 正 数 ijndex 获 取 单 个 字符 

Console.writeLine(text[^3]); <------ 使 用 倒数 index 获 取 单 个 字符 
Console,WriteLine(text[2..7]) <------ 使 用 range 获 取 子 串 























Span<int> Span = stackalloc int[] { 5, 2, 7, 8, 2, 4, 3 }; 
Console .WriteLine(span[2]); <------ 使 用 正 数 index 获 取 单 个 元 素 
Console,WriteLine(span[A3]);，<------ 使 用 倒数 index 获 取 单 个 元 素 
Span<int> slice = span[2..7]; <------ 使 用 range 创 建 一 个 数组 的 分 割 
Console.writeLine(string.Join(", ", slice.ToArray())); 


执行 结果 如 下 : 


1 











. 
]lo w 

7 

2 

1, 8, 2, 4, 3 


字符 串 和 span 索 引 器 都 接收 一 个 Range (不 包含 上 界 值 ): [2..7] 返 回 的 
是 索引 为 2，3，4，5，6 的 元 素 值 


代码 清单 15- 15 中 的 range 人 包含 了 开始 位 置 和 吉 束 位 置 的 索引 ， 每 个 索引 
值 都 是 从 前 问 后 数 的 。 只 要 索引 值 对 于 当前 序列 合理 ， 就 可 以 指定 任何 
范围 。 例 如 text[^5， 就 会 返回 wor1d 这 个 字符 串 ， 它 是 text 的 最 后 5 
个 字符 。 


类 似 地 ， 也 可 以 使 用 text[^16..5]， 那 么 将 返回 ello。 因 为 hello world 
这 个 字符 串 的 长 度 为 11， 那 么 A16 的 索引 值 等 同 于 1， 所 以 text[^A10..5] 
3 (在 这 个 例子 中 它 取 决 于 text 的 长 度 ) text[1..5]， 于 是 就 返回 
了 第 一 个 字符 后 面 的 4 个 字符 。 下 面 介绍 关于 异步 的 语言 特性 支持 。 


15.5 更 多 异步 集成 
C# 5 引入 async/await， 改 变 了 很 多 C# 开 发 人 员 使 用 异步 的 方式 ; 不 过 目 
前 仍 有 一 些 语言 特性 是 同步 方法 ， 这 些 特性 阻碍 了 整 门 语言 向 异步 世界 
的 演进 。 本 节 内 容 包 括 : 

9 异步 回收 ; 

e。 异步 迭代 (foreach) ; 

。 异步 迭代 器 (yield return) 。 


这 些 特性 既 需 要 语言 的 文 持 ， 也 需要 framework 的 文 持 。 由 编译 器 通过 














人 首先 介绍 相对 简单 的 异 
步 回 收 。 





15.5.1 ”使 用 await 实 现 异 步 资源 回收 
IDisposable 接 口 只 有 一 个 Dispose 方 法 ， 访 方法 自然 是 同步 方法 。 如 果 
方法 需要 执行 IO 操作 ， 例 如 刷新 一 个 流 ， 它 就 有 可 能 因为 一 些 问 题 而 
阻塞 。 

将 来 C# 8 会 为 文 持 异步 回收 的 类 引入 一 个 新 接口 : 


public interface IAsyncDisposable 








Task DisposeAsync(); 


} 


目前 不 要 求实 现 了 IAsyncDisposable 接 口 的 类 必须 实现 IDisposable 接 
口 ， 不 过 之 后 可 能 会 加 上 这 项 限制 。 


在 语言 层面 会 有 using await 语 句 。 自 然 ， 这 条 语句 会 自动 调 
用 DisposeAsync 方 法 ， 然 后 await 任 务 结果 人 返回。 代码 清单 15-16 展 示 了 
如 何 实现 和 使 用 该 接口 。 


代码 清单 15-16 ”实现 IAsyncDisposal 接 口 并 且 使 用 using await 调 
用 


class AsyncResource : IAsyncDisposable 


public async Task DisposeAsync() 


{ 
Console.writeLine("Disposing asynchronously..."); 
await Task.Delay(2000); 
Console.WriteLine("... done"); 

} 

public async Task PerformworkAsync() 

{ 
Console.WriteLine("Performing work asynchronously..."); 
await Task.Delay(2000); 
Console.WriteLine("... done"); 

} 


async static Task Main() 
Using await (var resource = new AsyncResource()) 
await resource,PerformworkAsync( ); 


Console.writeLine("After the using await statement"); 


执行 结果 展示 了 资源 回收 的 过 程 : 


Performing work asynchronously... 
. done 

Disposing asynchronously... 

... done 

After the using await statement 


这 么 看 并 不 复杂， 但 以 上 代码 隐藏 了 两 点 比较 重要 且 复 杂 的 内 容 。 


e。 类 库 通 常 使 用 configureAwait(false) 来 await 任 务 ， 应 用 程序 一 般 
不 需要 。 如 果 由 编译 器 上 自动 完成 ， 那 么 用 户 该 如何 配 置 呢 ? 

。 既然 提供 了 异步 回收 ， 自 然 应 该 有 相应 的 取消 机 制 ， 那 么 取消 操作 
应 当 如 何 纳 入 接口 昵 ? 又 该 何 时 调用 呢 ? 


C# 设 计 团 队 已 经 意识 到 了 以 上 两 点 ， 在 C# 8 发 布 之 前 这 两 个 问题 应 当 会 
得 到 解决 。C# 8 中 的 其 他 异步 特性 也 存在 同样 的 问题 ， 和 希望 这 些 领域 也 
能 够 以 类 似 的 方法 解决 问题 。 下 一 个 特性 是 使 用 foreach 的 异步 迭代 。 


15.5.2 ”使 用 foreach await 的 异步 欠 代 
在 开始 介绍 语言 特性 之 前 ， 有 很 多 论述 性 内 容 。 为 了 解释 清楚 该 特性 ， 


这 些 内 容 是 必须 的 。 使 用 异步 和 迭代， 将 得 到 以 下 合法 代码 ， 其 中 
asyncSequence 需 要 以 异步 方式 获取 元 素 : 

















foreach await (var item in asyncSequence) 


{ 
} 


异步 夫 代 的 接口 并 不 像 异 步 回收 那样 直 白 易 懂 。 和 异步 迭代 共有 两 个 接 


口 ，IEnumerable<T> 和 IEnumerator<T> 所 对 应 的 两 个 异步 接口 : 


Cs 使 用 item 





public interface IAsyncEnumerable<out T> 


{ 


IAsyncEnumerator<T> GetAsyncEnumerator(); 


public interface IAsyncEnumerator<out T> 


Task<bool> WaitForNextAsync( ); 
T TryGetNext(out bool success); 


} 


IAsyncEnumerable<T> 与 TEnumerable<T> 接 口 高 度 近 似 ， 因为 其 中 不 包含 
任何 异步 内 容 。 它 使 用 GetAsyncEnumerator() 取 代 了 GetEnumerator() 方 
法 ， 然 后 同步 返回 一 个 IAsyncEnumerator<T> 类 型 的 值 。 在 某 些 情况 下 这 
样 的 实现 方式 可 能 会 导致 问题 ， 但 我 认为 对 于 多 数 异 步 序 列 ， 这 是 上 自然 
方式 。 那 些 需 要 将 异步 操作 用 于 设置 的 实现 ， 可 能 需要 推迟 该 任务 ， 直 
到 调用 方 开始 迭代 结 


IAsyncEnumerator<T> 接 口 则 和 IEnumerator<T> 相 去 其 远 ， 它 反映 了 现实 
世界 中 的 一 种 常见 模式 。 有 异步 经 常用 于 有 IO 的 场景 中 ， 例 如 从 网 络 中 
获取 一 个 结果 。 异 步 获 得 的 结果 序列 经 常 是 拆 分 开 的 : 比如 执行 一 条 碍 
R00 然后 获取 接 下 来 的 7 条 ， 最 后 被 告知 已 经 传输 
元 成 。 











如 果 可 以 从 缓存 中 达 代 结果 集 ， 束 不 坝 要 异步 操作 了。 尽管 寞 步 操 作 电 
效 ， 但 终 完 存在 性 能 消耗 ， 所 以 应 当 尽 量 避 免 使 用 异步 。 只 要 能 够 确定 


和 欠 代 的 结束 位 置 ， 都 可 以 使 用 同步 欠 代 的 方式 。 
IAsyncEnumerator<T> 接 口 通过 两 个 方法 来 对 外 提供 这 种 模式 。 


。 WaitForNextAsync 是 异步 的 ， 它 会 返回 一 个 任务 用 于 指示 是 否 获取 
了 结果 ， 或 者 是 否 迭 代 到 了 序列 的 末尾 。 

。 TryGetNext 是 同步 的 ， 它 负责 返回 下 一 个 元 素 。out 参 数 用 于 指示 
是 否 有 下 一 个 元 素 返 回 4。 如 果 结 果 为 false， 也 并 不 意味 着 已 经 到 
达 了 序列 的 末尾 ， 而 只 表示 需要 再 次 调用 waitForNextAsync。 


4 这 个 方法 和 其 他 大 部 分 Tryxyz 方 法 不 同 。 它 返回 一 个 boo1 类 型 值 ， 然 
后 通过 out 参 数 返 回 获取 的 值 。 在 正式 发 布 之 前 应 该 还 会 有 变更 。 


上 述 内 容 听 起 来 比较 复杂 ， 不 过 通常 不 需要 目 行 实现 ， 新 的 foreach 























await 语 句 会 帮 我 们 处 理 好 一 切 。 


下 面 看 一 个 例子 。 我 在 和 Google Cloud Platform API 打 交道 期 间 频 繁 遇 
到 这 样 的 问题 。 很 多 API 有 1list 操 作 ， 例 如 列 出 某 个 地 址 短 的 联系 人 ， 或 
者 列 出 某 个 集群 中 的 虚拟 机 。 在 单 次 RPC 啊 应 中 如 果 返 回 太 多 结果 ， 就 
需要 一 个 基于 页 的 模式 : 每 个 响应 都 包含 一 个 “下 一 页 令 脾 ”客户 端 可 
以 使 用 该 令 牌 在 一 个 子 请 求 中 获取 更 多 数据 。 客 户 端 在 第 一 次 请 求 中 不 
提供 页 令 牌 ， 最 后 一 个 响应 也 不 包含 页 令 牌 。 代 码 清单 15-17 展 示 了 一 
个 简化 版 的 API。 


代码 清单 15-17 简化 版 的 RPC 服 务 : 列 出 城市 信息 


public interface IGeoService 








Task<ListCitiesResponse> ListCitiesAsync(ListCitiesRequest re 


} 
public class ListCitiesRequest 
{ 
public string PageToken { get; } 
public ListCitiesRequest(string pageToken) => 
PageToken = pageToken; 
} 
public class ListCitiesResponse 
{ 
public string NextPageToken { get; } 
public List<string> Cities { get; } 
public ListCitiesResponse(string nextPageToken, List<string> 
(NextPageToken, Cities) = (nextPageToken, cities); 
} 


当然 ， 一 般 不 会 直接 调用 上 述 方法 ， 通 常会 在 客户 端 将 其 封装 然后 对 外 
暴露 API， 见 代码 清单 15-18。 


代码 清单 15-18 对 RPC 服 务 进 行 封装 来 提供 简单 的 API 


public class GeoClient 


t 


public GeoClient(IGeoService service) { ... } <------ 通过 RPC 月 
public IAsyncEnumerable<string> ListCitiesAsync() { ... } <-- 


有 了 Geoclient 之 后 ， 就 能 轻松 使 用 foreach await 了 ， 见 代码 清单 15- 
19。 


代码 清单 15-19 ”对 Geoclient 使 用 foreach await 
var client = new GeoClient(service); 
foreach await (var city in client.ListCitiesAsync()) 


Console.writeLine(city); 





最 终 代 码 比 之 前 创建 例子 的 代码 要 简单 得 多 ， 而 且 无 顷 了 解 Geoclient 
的 内 部 实现 。 这 展示 了 该 特性 的 一 项 优势 。 我 们 通过 ITGeoservice 和 
IAsyncEnumerable<T> 完 成 了 相对 复杂 的 定义 ， 然后 仅 通 过 一 个 简单 有 效 
的 foreach await 就 完成 了 相应 的 消费 功能 。 


说 明 ” 随 书 代码 中 包含 了 一 个 完整 的 例子 ， 该 例子 使 用 了 内 存 版 的 
模拟 服务 实现 。 


有 一 件 事 或 许 令 人 吃惊 IAsyncEnumerator<T> 竟 然 没 有 实现 
IAsyncDisposable 接 口 。C# 8 版 本 最 终 发 布 前 这 一 点 可 能 会 有 变更 ， 如 
果 没 有 ， 我 认为 如 果 执 行 期 能 够 找到 相应 的 ITAsyncDisposable 实 现 ， 会 
由 编译 喜来 负责 释放 枚 举 器 。 


就 像 同步 版 的 foreach 语 句 一 样 ，foreach await 不 要 求实 现 
IAsyncEnumerable<T> 接 口 和 IAsyncEnumerator<T> 接 口 。 它 会 是 基于 模 
式 的 ， 因 此 任何 提供 了 GetAsyncEnumerator() 的 方法 都 可 以 支持 foreach 
await。 GetAsyncEnumerator() 需 要 方法 返回 一 个 提供 waitForNextAsync 
和 TryGetNext 方 法 的 类 型 。 虽 然 该 领域 还 有 优化 的 空间 ， 但 我 认为 多 数 
情况 下 依然 会 使 用 这 些 接口 。 


前 面 介绍 了 如 何 消费 异步 序列 ， 那 么 如 何 生 成 异步 序列 呢 ? 
15.5.3 ”有 寞 步 迄 代 器 
C# 2 通过 yield return 语 句 和 yield break 语 句 引 入 了 迭代 器 的 概念 ， 使 


得 返回 IEnumerable<T> 或 者 IEnumerator<T> 类 型 的 方法 易于 编写 。C# 8 
会 针对 异步 序列 提供 对 等 的 特性 。 目 前 预览 版 中 还 没有 提供 该 特性 ， 代 




















码 清单 15-20 是 基于 推断 的 合理 猜测 。 
代码 清单 15-20 ”使 用 迭代 堪 实 现 ListcitiesAsync 
public async IAsyncEnumerable<string> ListCitiesAsync( ) 


string pageToken = null; 
do 


{ 
var request = new ListCitiesRequest(pageToken); 
var response = await service.ListCitiesAsync(request); 
foreach (var city in response.Cities) 


yield return city; 


} 
pageToken = response.NextPageToken; 
} while (pageToken != null); 


异步 迭代 器 方法 和 IAsyncEnumerator<T> 接 口 之 间 的 映射 ， 以 及 其 同步 异 
步 混 合 的 部 分 ， 会 是 实现 中 的 难点 。 无 论 何 时 在 async 方 法 中 恢复 执 
行 ， 它 都 会 以 以 下 几 种 方式 完成 特定 的 调用 : 


。 await 某 个 未 完成 的 异步 操作 ; 

执行 到 某 条 yield return 语 人 句 ; 

执行 到 yield _ break 语句 ; 

执行 到 方法 的 结尾 ; 

抛 出 一 个 异常 。 

具体 如 何 处 理 这 些 情况 ， 还 要 看 调用 方 执 行 的 是 waitForNextAsync() 方 
法 还 是 TryGetNext() 方 法 。 为 了 提升 效率 ， 生 成 的 代码 应 当 能 够 在 同步 
模式 (yield 语句 之 间 没 有 await 语 句 ) 和 异步 模式 〈await 一 个 异步 操 
{> 之 间 切 换 。 我 能 够 大 致 推测 出 应 当 如 何 实现 ， 幸 好 不 需要 由 我 来 实 
现 。 


此 外 ， 还 有 一 些 特性 尚未 在 C# 8 预览 版 中 提供 ， 下 面 简要 介绍 。 
15.6 ” 预 宽 版 中 尚未 提供 的 特性 
即便 C# 8 最 后 只 提供 了 前 面 列举 的 几 项 新 特性 ， 也 称 得 上 是 一 个 重 磅 版 














本 。 其 实 我 更 希望 移 发 行 一 个 只 有 可 空 引 用 类 型 一 个 特性 的 版 本 ， 等 一 
年 左右 大 部 分 代码 库 完 成 可 空 引用 的 更 新 之 后 ， 再 发 布 其 他 特性 。 不 过 
C# 8 正式 发 布 的 特性 应 该 会 比 本 章 罗列 的 要 多 。 


本 节 所 探讨 的 特性 ， 都 是 我 认为 C# 8 最 有 可 能 推出 的 新 特性 。 当 然 ，C# 
设计 团队 或 者 外 部 开发 人 员 也 提出 了 其 他 很 多 特性 。C# 设 计 团队 使 用 
GitHub 来 退 踩 提议 ， 以 此 了 解 事项 的 进展 ， 也 方便 了 开发 人 员 目 行 页 
献 。 首 先 讨论 一 个 受 Java 语 言 启发 的 特性 。 


15.6.1 默认 接口 方法 


就 在 C# 为 LINQ 引 入 了 扩展 方法 的 同时 ，Java 末 用 了 不 同 的 方式 来 支持 
流 的 操作 ， 这 种 方式 覆盖 了 很 多 与 LINQ 相 同 的 使 用 场景 。 在 Java 8 中 ， 
Oracle 在 Java 接 口 引 入 了 默认 方法 : 一 个 接口 可 以 声明 一 个 方法 ， 并 提 
供 访 方法 的 一 个 默认 实现 ， 之 后 该 接口 的 实现 类 可 以 履 盖 该 默认 方法 。 
方法 的 默认 实现 不 能 声明 任何 与 字段 相关 的 状态 ， 它 必须 使 用 当前 接口 
的 其 他 成 员 进 行 表达 。 


这 两 个 特性 在 某 些 方面 有 相似 之 处 : 二 者 都 可 以 提供 一 部 分 现成 逻辑 ， 
这 样 接口 的 实现 类 可 以 不 必 都 实现 相应 的 方法 ， 接 口 的 消费 者 也 可 以 直 
接 调用 方法 。 这 两 个 特性 各 有 优 缺 点 。 


默认 方法 没有 扩展 方法 的 灵活 性 高 。 任 何人 《不 仅 限 于 接口 作者 ) 
都 可 以 引入 扩展 方法 ， 但 并 不 是 所 有 人 都 能 为 接口 添加 默认 方法 。 
(扩展 方法 也 适用 于 类 和 结构 体 。) 

实现 类 窗 畜 默认 方法 通常 是 出 于 优化 的 目的 。 扩 展 方法 不 能 被 宪 
六 ， 它 们 只 是 一 层 语 法 糖 ， 其 本 质 只 是 静态 方法 ， 只 是 在 调用 时 看 
起 来 像 是 普通 的 实例 方法 。 


关于 第 二 条 ， 使 用 LINQ 的 Enumerable.count() 方 法 时 可 以 感受 到 。 默 认 
情况 下 ， 它 通过 调用 GetEnumerator() 方 法 来 计算 序列 中 元 素 的 个 数 ， 然 
后 计算 调用 MoveNext() 返 回 true 的 昧 计 次 数 。 


很 多 IEnumerable<T> 的 实现 有 更 高 效 的 计算 元 素 个 数 的 方 

法 。Enumerable.count() 针 对 某 些 情况 专门 进行 了 优化 ， 例 如 
ICollection 和 ICcollection<T> 的 实现 。 但 是 如 果 某 个 集合 并 不 想 实 现 这 
两 个 接口 ， 但 依然 需要 提供 count 功 能 怎么 办 ?这 时 就 停滞 不 前 了 ， 因 
为 无 法 和 Enumerable.Ccount() 进 行 交 互 ， 不 能 有 效 地 目 行 实现 LINQ 的 这 















































部 分 功能 。 如 果 count() 方 法 是 IEnumerable<T> 的 一 个 默认 实现 ， 新 集合 
承 可 以 履 盖 该 方法 了 。 


C# 8 使 用 默认 接口 实现 来 声明 IEnumerable<T> 的 代码 如 下 : 


public interface IEnumerable<T> 





IEnumerator<T> GetEnumerator( ); 
int Count() 
using (var iterator = GetEnumerator()) 
int count = 0; 
while (iterator.MoveNext()) 


{ 
} 


COUnt++ ， 


} 


return count,; 


使 用 默认 接口 方法 ， 接 口 可 以 随 着 时 间 的 推移 以 版 本 友好 的 方式 不 断 扩 
展 。 可 以 添加 新 的 带 有 默认 实现 的 方法 ， 这 些 方法 可 以 使 用 现 有 成 员 实 
现 新 功能 ， 也 可 以 抛 出 NotSupportedException。 即 便 新 方法 无 法 保证 正 
常 调用 ， 旧 的 实现 依然 可 以 正常 构建 。 版 本 管理 是 一 个 很 复杂 的 话题 ， 
不 过 新 增 一 个 可 选 工 具 总 是 好 事 一 桩 。 它 能 在 很 大 程度 上 简化 现 有 代码 
的 维护 工作 。 


默认 接口 方法 是 一 个 有 争议 的 特性 。 它 需要 CLR 的 支持 ， 因 此 实验 该 特 
性 需要 全 力 投 入 。 如 果 C# 8 最 终 包含 了 该 特性 ， 那 么 它 的 采纳 率 将 很 有 
意思 。 可 能 在 文 持 它 的 运行 时 版 本 被 广泛 采纳 之 前 ， 不 会 有 太 多 人 使 
用 。 下 面 介绍 一 个 久 经 讨论 和 原型 设计 的 特性 。 











15.6.2 ”记录 类 型 


记录 类 型 的 先驱 特性 是 主 构造 器 ， 原 本 计划 C# 6 推出 该 特性 ， 但 是 C# 语 
言 设计 团队 对 该 特性 初始 设计 的 几 处 瑕 六 不 太 满意 ， 因 此 决定 延迟 引入 
该 特性 ， 直 到 找到 改进 方法 。 


记录 类 型 用 于 简化 茶 些 不 可 变 类 或 者 结构 体 的 创建 ， 这 些 类 或 者 结构 体 
根据 一 组 给 定 的 属性 进行 创建 。 我 倾 问 于 把 它们 看 作 始 于 匿名 类 型 ， 但 
站 
明 . 





public class Point(int x, int Y, int 2); 


这 一 名 代码 会 生成 若干 成 员 ， 我 们 也 可 以 引入 一 些 上 自 定 义 行为 。 生 成 的 
成 员 包括 : 构造 问 、 属 性 、 等 价 判断 方法 以 及 一 个 用 于 分 解 的 
Deconstruct 方 法 ， 还 有 一 个 with 方法 。with 方 法 实现 如 下 ; 


public Point With(int Xx = this.X, int Y = this.Y, int Z = this.Z) 
new Point(X, Y, 2); 


这 样 的 语法 不 符合 当前 对 于 可 选 形 参 黑 认 值 的 规则 ， 我 们 也 不 清楚 能 个 
采用 显 式 的 方式 ， 不 过 它 至 少 能 够 对 外 展现 方法 的 行为 意图 。 


with 方 法 用 于 通过 with 表 达 式 的 形式 和 新 语法 进行 交互 。 使 用 with 方 
法 ， 可 以 更 简单 地 根据 现 有 不 可 变 类 型 的 实例 创建 新 的 实例 。 创 建 的 实 
例 与 现 有 实例 相同 ， 但 会 有 一 个 或 多 个 属性 发 生变 化 。withFoo 方 法 在 
不 可 变 类 型 中 很 常见 (Foo 是 类 型 中 某 个 属性 的 名 称 〉， 但 它们 只 能 一 
次 作用 于 一 个 属性 。 假 设 有 一 个 不 可 变 的 point 类 型 ， 其 中 有 3 个 属 
性 x、Y 和 z， 可 以 如 下 所 示 创 建 一 个 新 的 point， 新 point 的 z 值 不 变 ， 只 蔡 
换 其 x 和 Y 值 。 


var newPoint = oldPoint .withx(10).withY(20); 


每 个 withFoo 方 法 都 会 调用 一 个 构造 器 ， 把 除 方法 名 称 中 属性 外 的 其 他 
属性 值 都 作为 参数 传 入 ， 然 后 对 参数 中 指定 的 值 进行 赋值 。 这 些 方法 写 
起 来 很 烦琐 ， 并 且 有 淤 在 的 性 能 问题 。 如 有 果 要 改变 N 个 属性 ， 惑 需要 调 
用 N 次 withFoo 方 法 ， 每 次 调用 都 会 创建 一 个 新 的 对 象 。 

记录 类 型 的 with 方法 则 不 同 ; 它 为 当前 类 型 的 每 个 属性 都 提供 了 一 个 参 


数 ， 如 果 某 个 参数 没有 被 指定 ， 那 么 该 参数 使 用 默认 值 。 使 用 默认 值 的 
参数 将 从 当前 对 象 的 属性 获取 值 。 例 如 对 于 point 类型， 可 以 直接 调 
用 : 











var newPoint = oldPoint.With(X: 10, Y: 20); 





或 者 使 用 新 的 with 表达 式 语 法 ， 看 起 来 就 像 一 个 对 象 初始 化 绒 : 
var newPoint = oldPoint with {X= 10, Y = 20 }; 


0 
对 家 。 


这 只 是 简单 的 例子 。 如 果 是 一 个 复杂 的 类 型 ， 而 且 只 需要 修改 其 中 某 个 
叶子 节点 ， 情 况 就 会 变 得 十 分 复杂 。 假 设 有 一 个 包含 Address 属 性 的 
contact 类 型 ， 现 在 需要 创建 一 个 新 的 contact， 新 对 象 和 原 对 象 除了 
Address 属 性 ， 其 他 都 相同 。 可 能 在 C# 8 中 完成 这 样 一 项 任务 依然 有 些 
办 难 ， 但 是 可 能 会 通过 增强 with 表 达 式 来 简化 该 过 程 ， 束 和 像 模式 匹配 特 
性 那样 不 断 强 化 。 


对 于 未 来 的 这 种 可 能 性 ， 我 感到 激动 不 已 。 在 C# 语 言 中 ， 不 可 变 类 型 一 
直 是 创建 难 、 操 作 难 的 典型 。C# 7 中 的 元 组 类 型 填补 了 由 匿名 类 型 留 下 
的 一 处 空缺 ， 而 记录 类 型 会 填补 另 一 处 。 我 一 直 很 满意 编译 器 在 处 理 匿 
名 类 型 时 生成 的 那些 等 价 操作 、 构 造 占 以 及 属性 代码 。 如 果 之 后 不 能 为 
其 命名 或 者 添加 更 多 功能 ， 将 是 憾事 。 记 录 类 型 的 出 现 解 决 了 这 些 问 
题 。 下 面 看 一 些 比较 异想天开 的 新 特性 。 


15.6.3 ”更 多 特性 


虽然 还 有 一 些小 特性 可 能 会 出 现在 C# 8 中 ， 但 是 这 些 特性 没有 接 下 来 要 
讨论 的 有 趣 。 请 记 住 ， 访 问 GitHub 可 以 了 解 C# 的 最 新 状态 。 


1. 类 型 类 (概念 、 数 据 形态 或 者 结构 性 沁 型 约束 ) 


虽然 泛 型 适用 于 很 多 场景 ， 但 它 也 有 局 限 性 。 很 多 数据 形态 无 法 用 
泛 型 来 表示 ， 例 如 运算 符 和 构造 器 。 虽 然 可 以 要 求 某 个 类 型 实 参 具 
备 一 个 无 参 构造 器 ， 但 是 不 能 要 求 该 构造 器 具有 特定 参数 列表 。 此 
外 ， 不 同 的 类 型 可 能 需要 相同 的 数据 形态 ， 但 它们 并 不 实现 相同 的 
接口 ， 也 没有 共同 的 其 类 (system.0bject 除 外 ) 。 类 型 类 就 是 为 
了 解决 这 些 问题 而 提出 的 。 类 型 类 可 能 会 类 似 于 接口 ， 但 是 其 实现 
人 


虽然 该 特性 可 以 解决 一 些 潜在 的 问题 ， 但 会 造成 一 定 的 困惑 。 我 目 















































己 对 此 也 有 些 举 棋 不 定 。 一 方面 ， 它 应 该 会 要 求 运行 时 的 某 些 变更 
来 保证 执行 效率 ，C# 开 发 人 员 ( 至 少 是 我 ) 可 能 需要 花 一 些 时 日 才 
能 找到 它 的 适用 /不 适用 场景 。 鉴 于 C# 语 言 如 今 的 成 熟 度 ， 为 其 添 
加 一 个 全 新 的 类 型 ， 无 疑 是 一 项 重大 改变 。 另 一 方面 ， 该 特性 肯定 
能 够 填补 C# 语 言 的 某 块 空白 : 当 我 们 需要 这 样 一 个 功能 时 ， 现 有 工 
具 无 法 提供 恨 好 的 解决 方案 。 





. 一 切 间 可 扩展 


在 本 书 编写 之 时 ， 该 特性 刚 在 GitHub 上 达到 X.0 版 本 里 程 碑 ， 但 是 
它 的 优先 级 上 调 的 话 ， 也 丝 野 不 令 人 意外 。 顾 名 思 义 : 扩展 方法 的 
理念 可 以 应 用 于 其 他 成 员 类 型 ， 例 如 属性 、 构 造句 以 及 运算 符 。 此 
外 ， 可 能 还 会 推出 静态 扩展 成 员 : 看 起 来 像 是 扩展 类 型 的 静态 方法 
(例如 为 stringExtensions 新 增 一 个 方法 ， 访 方法 可 以 更 有 针对 性 
地 调用 string.IsNullorTabs 而 不 是 string.IsNullorwhitespace) o 


扩展 方法 的 语法 可 能 不 适用 于 成 员 类 型 ， 因 此 应 该 会 引入 全 新 的 语 
法 。 它 可 能 会 以 扩展 类 型 的 方式 出 现 ， 由 该 扩展 类 型 负责 创建 所 有 
扩展 成 员 。 


扩展 类 型 也 不 会 引入 新 的 状态 。 扩 展 属性 可 能 会 提供 现 有 属性 的 不 
同 视图 。 例如 可 以 为 DateTime 属 性 添加 一 个 名 为 FinancialQuarter 
的 扩展 属性 ， 该 扩展 属性 具有 公司 财务 报表 的 日 期 ， 并 且 使 用 现 有 
的 Year/Month/Day 属 性 来 计算 相应 的 季度 。 














.目标 类 型 锁定 的 new 


当 类 型 名 称 了 见长 时 ， 使 用 隐 式 类 型 声明 var 可 以 简化 代码 。 但 是 隐 
0 
码 仍 为 : 


Dictionary<string, List<DateTime>> entryTimesByName = 
new Dictionary<string, List<DateTime>>(); 


有 了 目标 类 型 锁定 new 特 性 之 后 ， 声 明 语 名 的 右 半 部 分 可 以 大 幅 缩 
短 : 


Dictionary<string, List<DateTime>> entryTimesByName = new(); 


在 调用 构造 器 时 ， 只 要 编译 需 能 够 确定 其 类 型 ， 就 可 以 省 略 整个 类 
型 名 称 。 该 特性 为 成 员 调 用 引入 了 额外 的 复杂 性 。 例 如 
Method(new()) 这 样 的 调用 ， 编 译 器 可 以 通过 方法 形 参 来 获取 目标 
类 型 《只 要 Method 不 是 泛 型 或 者 重 载 方法 ) 。 


对 于 该 特性 的 提议 ， 我 是 既 爱 且 恨 ， 而 且 这 两 种 情感 难 解难 分 。 如 
果 不 加 市 制 地 使 用 该 特性 ， 那 么 代码 将 变 得 生 深 难 读 不 过 任何 特 
0 
过程。 


我 认为 该 特性 甚至 比 默认 接口 方法 特性 更 具 争 议 性 。 我 们 将 静观 局 
势 友 展 ， 也 欢迎 大 家 加 入 讨论 。 


15.7 ”欢迎 加 入 


C# 语 言 的 设计 过 程 正 处 于 前 所 未 有 的 开放 状态 。 尽 管 很 多 工作 是 在 微软 
办 公 室 的 语言 设计 会 议 (LDM) 中 完成 的 ， 但 社区 也 广泛 参与 其 中 ， 
例如 通过 GitHub 上 的 代码 仓库 。 其 中 包含 了 来 自 LDM 的 记录 、 提 议 、 
讨论 以 及 代码 规范 等 。 欢 迎 大 家 通过 各 种 方式 参与 C# 语 言 的 设计 


。 试用 预 损 版 构建 ， 看 看 新 特性 是 否 适 合 当前 代码 ; 
。 讨论 现 阶段 提议 的 特性 ; 

。 提议 新 特性 ; 

。 在 Roslyn 中 做 新 特性 的 原型 设计 ; 

。 大助 在 语言 规范 中 设计 和 规划 新 的 特性 ; 

。 从 现 有 语言 规范 中 找 错 (已 有 发 生 )。 


读者 可 能 会 觉得 静 候 完 整 版 发 布 更 好 ， 届 时 会 有 完善 的 文档 以 及 反复 打 
磨 好 的 实现 。 这 当然 没有 问题 。 欢 迎 随 时 但 看 那些 提议 特性 的 里 程 碑 ， 
也 随时 欢迎 加 入 。 


这 种 开放 式 的 设计 流程 还 比较 新 绪 ， 随 着 时 间 的 推移 ， 相 关 流 程 还 会 不 
汤 优化 。C# 设 计 团 队 应 该 不 会 退回 到 以 前 封闭 式 的 设计 方式 。 尺 管 让 社 
区 参与 语言 的 设计 大 大 增加 了 C# 设 计 团队 的 时 间 成 本 ， 但 是 确保 新 特性 
为 开发 人 员 所 接纳 和 解决 真正 的 需求 更 重要 。 

















15.8 ”小 结 


本 章 的 文字 性 内 容 较 多 ， 代 码 相对 较 少 ， 主 要 因为 我 不 希望 提供 的 代码 
在 C# 8 发 布 之 后 被 证 明 是 错 的 。 本 章 所 讨论 的 特性 不 会 都 出 现在 C# 8 
中 ， 但 至 少 其 中 一 部 分 会 。 如 果 可 空 引 用 类 型 或 者 模式 相关 特性 没有 出 
现在 C# 8 中 ， 就 太 不 可 思议 了 。 


之 后 昵 ? 可 能 会 发 布 C# 8 的 一 些小 版 本 ， 然 后 推出 C# 9。 有 些 C# 9 的 特 
性 可 能 已 经 在 GitHub 上 提交 审议 了 ， 但 我 认为 应 该 会 有 一 些 大 家 从 未 讨 
论 过 的 特性 。 我 认为 ， 随 着 计算 机 科学 的 不 断 发 展 ，C# 也 将 一 直 演 进 以 
不 断 满足 开发 人 员 的 新 需要 。 


附录 ”特性 与 语言 版 本 对 照 


本 书 内 容 基 本 上 是 按照 C# 的 版 本 顺序 编写 的 ， 但 是 读者 一 般 很 难 对 每 个 
版 本 所 对 应 的 特性 有 直观 的 感受 。 在 C# 7 引入 小 版 本 号 之 后 更 是 如 此 ， 
C# 7 的 特性 都 是 在 C# 7.0 特 性 基础 上 做 的 改进 。 


此 外 ， 在 使 用 特性 时 ， 需 要 清楚 该 特性 是 否 对 运行 时 或 framework 版 本 
有 要 求 。 本 附录 旨 在 为 读者 提供 一 份 简洁 明了 的 特性 -版 本 对 照 表 。 


本 书 正文 未 介绍 泛 型 类 型 推断 随 语言 版 本 演进 的 过 程 。 泛 型 类 型 推断 曾 
发 生 多 次 变更 ， 这 些 变更 很 难 用 一 两 句 话 描述 清楚 。 可 将 该 过 程 简单 理 
解 为 C# 语 言 每 次 版 本 更 新 ， 泛 型 类 型 推断 都 会 改进 。 














委托 协 变 和 逆 变 1 
迭代 器 〈yield return) 


gettersetter 分 离 的 属性 访问 
命名 空间 别名 限定 符 :: 
全 局 命名 空间 别名 








司 部 方法 

动 实现 的 属性 

隐 式 类 型 局 部 变量 (var) 
隐 式 类 型 数组 (new[]) 
对 象 初始 化 器 

集合 初始 化 器 

匿名 类 型 


lambda 表 达 式 (委托 ) 
有 人 需要 运行 时 和 framework 的 支持 


Se 
扩展 万 法 (attribute) 
查询 表达 式 | 
需要 framework 的 支持 (虽然 名 


字 叫 动态 语言 运行 时 ， 但 它 并 
不 属于 运行 时 ) 


下 


出 





on 


A 
六 





动态 类 型 





可 选 形 参 
命名 实 参 


I 


链接 主 互 操作 程序 集 要 运行 时 和 framework 的 支持 
COM 中 可 选 形 参 的 特殊 规则 
命名 索引 的 访问 〈 仅 限 COM) 

ee framework 调 整 为 已 有 的 接口 和 
区 EE 

需要 framework 的 支 
lock 语 句 的 实现 变更 持 : Monitor .Enter(object， 
ref bool) 


| 


类 字段 事件 的 实现 变更 


人 H 


企 声 明 类 中 访问 类 字段 事件 








行为 上 的 变更 ， 但 仅 限 于 此 前 


ER roreach 迁 代 变量 捕获 的 变更 | 反 加 二 内 训 是 有 全 和 页 的 代码 
和 需要 framework 的 支持 


|C# 6 
| 自动 实现 的 只 读 属 性 | 
| 自动 实现 属性 的 初始 化 器 | 
移 除 关 于 在 包含 自动 实现 属性 的 结构 体 ] 
构造 器 中 调用 this() 的 要 求 
| 


表达 式 主体 成 员 














当 对 应 类 型 和 
FormattablestringFactory 可 用 
时 ， 需 要 为 FormattableString 


提供 额外 的 文 持 
| 
bemoanoBs | 
ER 
[有 edu 方才 的 全 Sif | 
[ER 


空 值 条 件 运算 符 ?? 








移 除 在 try/catch、try/finally 和 和 

try/catch 中 使 用 await 的 限制 

Cc#70 
加 要 framework 的 支持 

组 这 





在 C# 7. 2 编 详 器 之 前 需要 提供 


ey Fp] LN 人 区 ~ 2 








常量 模式 、 类 型 模式 、var 模 式 


| | 上 的 变更 ) 
| 





通过 is 操作 符 使 用 模式 特性 


| 
在 swtich 语 句 中 使 用 模式 匹配 〈 包 括 
when 哨 兵 语 句 ) 
or hh 
rm | 
|= 进 制 整数 字面 量 。 | oe 
| 


数字 字面 量 中 使 用 下 划 线 分 隅 符 





需要 framework 的 支持 
(attribute ) 


异步 方法 中 返回 自 定义 task 类 型 


更 多 形式 的 表达 式 主体 

C# 7.1 

ea mm 
针对 泛 型 值 的 类 型 模式 匹配 改进 

async 入 口 方法 (async Task Main) | 

元 组 元 素 名 称 推断 | | 
|C# 7.2 

ref 使 用 条 件 操作 符 ?: | 

调用 返回 ref readonly 的 方 
法 ， 需 要 编译 器 的 支持 。 此 
ref 只 读 局 部 变量 和 返回 类 型 外 ， 在 编译 时 需要 
InAttribute， 不 过 从 .NET 1.1 
和 .NET Standard 1.1 起 就 提供 了 
需要 IsReadonlyAttribute， 但 
当 目 标 framework 中 没有 时 ， 会 
随 output 一 并 提供 

只 读 结 构 体 | 需要 有 IsReadonlyAttribute 
使 用 ref/in 参 数 的 扩展 方法 


















需要 有 IsReadonlyAttribute。 
此 外 ， 类 Mref` 结 构 体 应 用 了 


obsoleteAttribute， 并 提供 了 


类 ref 结 构 体 一 条 特殊 的 信息 。 能 够 识别 
类 ref 结 构 体 的 编译 器 会 忽略 该 
attribute， 但 其 他 编译 器 会 提供 
正在 使 用 的 类 型 信息 








Span<T> 的 栈 内 存 分 配 的 文 持 需要 framework 的 支持 
非 尾部 命名 实 参 的 位 置 限制 | 
private protected 访 问 修饰 符 | 


| 
Cc#73 


不 使 用 fixed 语 句 访 问 固定 大 小 缓冲 区 
需要 能 够 文 持 元 组 ， 但 没有 增 





在 字段 、 属 性 和 构造 器 初始 化 占 中 使 用 
模式 匹配 和 out 变 量 


ref 局 部 变量 的 重新 赋值 
stackalloc 语 句 的 初始 化 器 | 


使 用 GetPinnableReference 的 基于 模式 
的 fixed 语 句 


类 型 约束 增加 枚 举 和 委托 类 


版 本 足够 新 的 编译 器 才能 识别 
使 用 unmanaged 约 束 的 类 型 和 方 
> 大 二 本 

针对 非 托管 对 象 的 新 涝 型 类 型 约束 上。 蛇 咎 ， 还 十 这 

从 .NET 1.1 和 .NET Standard 1.1 
起 提供 了 该 类 型 


字段 的 attribute 支 持 自动 实现 的 属性 | 























! 这 里 指 的 是 通过 方法 来 构建 委托 ， 使 用 的 是 兼容 但 是 不 完全 一 致 
的 方法 签名 。 它 和 C# 4 中 的 泛 型 型 变 有 所 区 别 。 


看 完了 


如 果 您 对 本 书 内 容 有 疑问 ， 可 发 邮件 至 contact@turingbook.com， 会 有 编 
辑 或 作 译 者 协助 答疑 。 也 可 访问 图 灵 社 区 ， 参 与 本 书 讨论 。 


如 果 是 有 关 电 子 书 的 建议 或 问题 ， 请 联系 专用 客服 邮箱 : 


ebook(Oturingbook.com 。 
在 这 里 可 以 找到 我 们 : 


微 博 @ 图 灵 教 育 : 好 书 、 活 动 每 日 播报 

微 博 @ 图 灵 社 区 : 电子 书 和 好 文章 的 消息 

微 博 @ 图 灵 新 知 : 图 灵 教 育 的 科普 小 组 

微 信 图 灵 访 谈 : ituring_interview， 讲 述 码 农 精 彩 人 生 
微 信 图 灵 教 育 : turingbooks 
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